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C# 是 一 门面 向 Microsoft NET 平台 开发 者 的 语言 。Microsoft 将 Cft 描述 为 一 种 用 于 NET 
平台 开发 的 富 于 创新 的 现代 化 语言 ， 并 且 在 C# 6.0 中 增添 了 用 于 支持 动态 编程 、 并 行 编程 
以 及 编写 更 少 代 码 的 新 功能 ， 进 一 步 实现 了 这 个 目标 。C# 不 仅 同时 支持 声明 式 编 程 和 函 
数 式 编程 ， 还 包含 了 强大 的 面向 对 象 特 性 。 简 而 言 之 ， 用 C# 可 以 针对 特定 问题 采取 不 同 
的 编程 风格 。 


我 们 基于 自己 最 初学 习 CH 时 遇 到 的 编程 问题 开始 了 本 书 的 编写 ， 并 且 根 据 C# 语言 中 的 新 
问题 和 新 功能 不 断 地 扩展 内 容 。 在 这 一 版 中 ， 我 们 重新 编写 了 许多 解决 方案 ， 以 充分 利用 
CH 最 近 的 创新 ， 例 如 新 的 表达 式 级 别 功 能 (nameof、 字 符 串 插值 、null 条 件 运 算 符 、 索 引 
初始 值 设 定 项 ) 、 成 员 声明 功能 (自动 属性 初始 值 设 定 项 、getter-only 自动 属性 、 表 达 式 - 
函数 体 成 员 ) 和 语句 级 别 功能 (异常 过 滤器 )。 同 时 ， 我 们 在 原 有 及 新 的 范例 中 纳入 了 动态 
fE (C#4.0) 和 异步 编程 (C# 5.0) 的 新 应 用 ， 帮 助 读者 了 解 如 何 应 用 这 些 语言 特性 。 


无 论 是 首次 学 习 C#， 还 是 探索 其 新 的 能 力 ， 抑 或 是 处 理 开 发 周期 中 较为 罕见 的 问题 ， 每 个 
人 都 会 遇 到 一 些 常见 (和 不 那么 常见 的 ) 陷阱 和 问题 ， 希 望 我 们 的 以 上 增补 能 帮助 读者 解决 
难题 。 此 外 ， 尽 管 Microsoft 已 经 提供 了 大 量 的 功能 以 避免 人 们 “重复 创造 轮子 ”， 但 是 我 们 
仍然 发 现 NET Framework 类 库 (Framework class library, FCL) 中 有 一 些 缺 少 的 内 容 ， 并 将 
其 纳入 了 本 书 的 范例 。 一 些 解 决 方案 你 可 能 马上 会 用 到 ， 也 有 一 些 你 可 能 永远 都 用 不 到 ， 但 
是 无 论 如 何 ， 我 们 都 希望 这 本 书 能 够 帮助 你 尽 可 能 充分 地 利用 C# 和 NET Framework, 

本 书 的 内 容 按照 一 个 CH 程序 员 在 学 习 过 程 中 要 解决 的 问题 类 型 来 进行 组 织 。 这 些 解决 方 
案 称 为 范例 (recipe) ; 每 个 范例 都 包含 一 个 问题 、 其 解决 方案 、 对 解决 方案 的 讨论 和 其 他 
相关 信息 ， 最 后 是 一 个 资源 列表 ， 包 括 在 FCL 的 哪里 可 以 找到 相关 类 的 更 多 信息 、 相 关 文 
章 和 其 他 范例 。 这 种 问答 模式 提供 了 问题 的 完整 解决 办 法 ， 使 得 本 书 易于 阅读 和 使 用 。 几 
平 每 个 范例 都 包含 完整 的 、 有 文档 的 代码 示例 ， 问 读者 展示 如 何 解决 特定 的 问题 ， 同 时 也 
讨论 了 底层 技术 如 何 运 作 ， 并 且 列 出 了 替代 技术 、 限 制 条 件 和 应 用 时 要 考虑 的 其 他 事项 。 


读者 对 象 


即使 你 不 是 经 验 丰 富 的 C# 或 .NET 开发 人 员 ， 也 可 以 使 用 本 书 一 一 本 书面 向 所 有 级 别 的 读 
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xi 


者 。 本 书 既 提 供 了 开发 人 员 日 常 问 题 的 解决 方案 ， 也 包含 了 一 些 出 现 频率 较 低 的 问题 。 书 
中 范例 针对 的 是 现实 开发 人 员 需 要 立刻 解决 的 问题 ， 不 需要 首先 学 习 大 量 理论 知识 。 虽 然 
参考 书 和 教程 类 书籍 可 以 讲述 通用 概念 ， 但 通常 不 提供 读者 解决 实际 问题 所 需 的 帮助 。 我 
们 选择 通过 示例 来 教学 ， 因 为 这 是 大 多 数 人 自然 的 学 习 方式 。 

本 书 中 解决 的 大 多 数 问题 是 C# 开发 人 员 会 频繁 面 对 的 ， 但 有 一 些 更 高 级 的 问题 需要 结 
多 项 技术 的 复杂 方案 。 每 个 范例 旨 在 帮助 开发 人 员 快 速 理 解 问 题 ， 学 习 如 何 解决 ， 并 找 
任何 潜在 的 权衡 选择 来 帮助 你 快速 、 高 效 、 轻 松 地 解决 问题 。 

为 了 免 去 读者 手动 输入 解决 方案 的 麻烦 ， 我 们 在 O'Reilly 的 网 站 上 提供 了 本 书 的 示例 代 
码 ， 以 方便 “编辑 继承 ”模式 的 开发 〈 复 制 和 粘贴 )， 同 时 有 助 于 经 验 较 少 的 开发 人 员 看 
到 优秀 的 编程 实践 。 示 例 代 码 提供 了 利用 到 每 个 解决 方案 的 可 运行 测试 ， 不 过 本 书 也 在 每 
个 解决 方案 中 包含 了 足够 的 代码 ， 读 者 不 使 用 示例 代码 也 能 够 实现 解决 方案 。 示 例 代 码 可 
以 从 本 书 的 产品 页 面 (https://github.com/oreillymedia/c_sharp_6_cookbook) 上 获取 '。 


硬件 和 软件 要 求 


要 运行 本 书 中 的 示例 ， 你 需要 一 台 运 行 Windows 7 或 更 高 版 本 的 计算 机 。 一 部 分 网 络 和 
XML 解决 方案 需要 Microsoft IIS 7.5 或 更 高 版 本 ， 第 9 章 中 FTP 的 范例 需要 一 个 本 地 配置 
好 的 FTP 服务 器 。 

打开 和 编译 本 书 中 的 示例 需要 Visual Studio 2015。 如 果 你 精通 可 下 载 的 Framework SDK 及 
其 命令 行 编译 器 ， 也 可 以 顺利 地 使 用 本 书 和 示例 代码 。 


平台 说 明 

本 书 中 的 解决 方案 都 是 使 用 Visual Studio 2015 开发 的 。C# 6.0 和 C# 3.0 之 间 的 差异 是 非常 
显著 的 ， 本 书 的 示例 代码 与 第 3 版 中 有 很 大 不 同 ， 反 映 了 其 中 的 差异 。 

值得 一 提 的 是 ， 尽 管 C# 现在 已 经 是 6.0 版 ，.NET Framework 则 仍 是 4.6 版 。C# 随 着 .NET 
Framework 的 每 次 发 布 持续 创新 ， 现 在 的 C# 6.0 中 包含 许多 功能 ， 使 得 开发 人 员 可 以 用 最 
适合 手头 任务 的 风格 进行 编程 。 


内 容 结构 


本 书 共 分 为 13 章 ， 每 一 章 侧重 于 特定 主题 的 CH 解决 方案 。 下 面 总 结 了 每 一 章 的 要 点 ， 概 
述 了 本 书 的 内 容 。 
。 第 1 章 类 和 泛 型 
这 一 章 篇 幅 很 长 ， 包 含 处 理 类 和 结构 数据 类 型 的 范例 ， 以 及 泛 型 的 使 用 。 泛 型 能 够 让 
你 的 代码 在 不 同类 型 的 值 上 运行 一 致 。 这 一 章 涵盖 的 范例 范围 很 广 ， 包 括 闭 包 、 类 转 
、 完 善 的 命令 行 参数 处 理 系 统 以 及 类 设计 的 主题 。 有 的 范例 增强 了 读者 对 泛 型 的 整 
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HE 1: 示例 代码 也 可 以 在 图 灵 社 区 本 








d 








主页 (http://www.ituring.com.cn/book/1746) 下 载 。 一 一 编者 注 
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体 理解 ， 有 的 范例 涵盖 了 泛 型 何 时 适用 ， 框 架 中 提供 了 哪些 支持 ， 以 及 如 何 实 现 自 定 
义 集合 。 

第 2 章 KO, MÆ RRNA 

这 一 章 范 例 考 察 了 集合 、 枚 举 器 和 迭代 器 的 用 法 。 集 合 的 范例 使 用 了 数组 ( 单 维 、 多 
维和 锯齿 状 )、List<T> 以 及 其 他 集合 类 ， 并 且 扩 展 了 它们 的 功能 。 这 一 章 讨论 了 泛 型 
集合 以 及 创建 自 定 义 强 类 型 集合 的 多 种 方式 。 我 们 探讨 了 自 定义 枚 举 器 的 创建 ， 向 读 
者 展示 了 如 何 为 泛 型 和 非 泛 型 类 型 实现 迭代 器 以 及 如 何 使 用 返 代 器 实现 foreach 功能 ， 
并 涵盖 了 自 定 义 返 代 器 实现 。 

第 3 章 数据 类 型 

这 一 章 包括 字符 串 、 数 字 和 枚 举 。 这 些 范 例 展示 了 如 何 完成 诸如 编码 / 解码 字符 串 、 执 
行 数值 转换 ， 以 及 测试 字符 串 以 确定 它们 是 否 包 含 数字 值 的 任务 。 我 们 还 介绍 了 如 何 
显示 、 转 换 和 测试 枚 举 类 型 ， 以 及 如 何 使 用 包含 位 标志 的 枚 举 。 

第 4 章 ， 语言 集成 查询 和 lambda 表达 式 

这 一 章 涵 盖 语 言 集成 查询 (language integrated query, LINQ) 及 其 用 法 ， 包 括 并 行 
LINQ (parallel LINQ, PLINQ) 的 一 个 示例 。 有 些 范例 使 用 了 诸多 标准 查询 运算 符 ， 也 
有 些 展示 了 如 何 使 用 功能 强大 但 并 不 是 语言 关键 字 的 查询 运算 符 。 这 一 章 也 对 lambda 
表达 式 进 行 了 探讨 ， 通 过 范例 展示 如 何 用 其 代替 旧 风 格 的 委托 。 

第 5 章 调试 和 异常 处 理 

这 一 章 介 绍 调试 和 异常 处 理 。 我 们 提供 了 使 用 System.Diagnostics 命名 空间 下 数据 类 
型 的 范例 ， 例 如 事件 日 志 、 进 程 、 性 能 计数 器 和 类 型 的 自 定义 调试 器 显示 。 我 们 同时 
关注 了 在 应 用 程序 中 实现 异常 处 理 的 最 佳 方 式 。 这 一 章 还 包括 了 避免 未 处 理 异常 ， 读 
取 和 显示 栈 跟踪 ， 51 发 和 重新 引发 异常 的 范例 。 最 后 ， 我 们 提供 的 范例 展示 了 如 何 克 
服 某 些 棘手 的 情形 ， 如 后 期 绑 定 调用 的 方法 中 出 现 的 异常 和 异步 异常 处 理 。 
$63 反射 和 动态 编程 

这 一 章 展 示 了 如 何 使 用 NET Framework 内 置 的 程序 集 检视 系统 ， 确 定 一 个 程序 集中 实 
现 了 哪些 类 型 、 接 口 和 方法 ， 以 及 如 何以 后 期 绑 定 的 方式 访问 它们 。 这 一 章 也 说 明了 
如 何 使 用 dynamic. ExpandoObject 和 DynamicObject 在 应 用 程序 中 实现 动态 编程 。 

第 7 章 正则 表达 式 

这 一 章 介 绍 了 一 组 有 用 的 类 ， 用 于 对 字符 串 运行 正则 表达 式 。 范 例 包 括 列举 正则 表达 
式 匹 配 ， 将 字符 串 解析 为 一 组 标记 ， 查 找 /替换 字符 ， 以 及 验证 正则 表达 式 的 语法 。 此 
外 我 们 还 加 入 了 一 个 范例 ， 其 中 包含 许多 常见 的 正则 表达 式 模式 。 

















































































































第 8 章 ， 文件 系统 IO 
这 一 章 涉 及 与 文件 系统 交互 的 三 种 不 同方 式 : 典型 的 文件 交互 ， 基 于 目录 或 文件 夹 的 
交互 ; 文件 系统 VO 的 高 级 主题 。 








第 9 章 网 络 和 Web 

这 一 章 探 计 了 由 NET Framework 提供 的 连接 选项 ， 以 及 如 何以 编程 方式 访问 网 络 资源 
和 Web 上 的 内 容 。 这 一 章 中 的 范例 包含 了 直接 使 用 TCP/IP， 使 用 命名 管道 通信 ， 构 建 
自己 的 端口 扫描 程序 ， 以 编程 方式 确定 网 站 配置 ， 等 等 。 

第 10% XML 

如 果 你 在 使 用 .NET， 那 么 很 可 能 需要 在 一 定 程度 上 处 理 XML。 在 这 一 章 中 ， 我 们 
将 探讨 XML 的 一 些 作用 ， 以 及 如 何 使 用 LINQ to XML, XmlReader/Xmlwriter 类 和 
XmLDocument 类 来 进行 XML 编程 。 这 一 章 包含 了 使 用 XPath 和 XSLT 的 示例 ， 以 及 验 
lE XML, 34 XML 转换 到 HTML 等 主题 。 






































第 11 章 安全 

编写 不 安全 代码 的 方式 有 很 多 种 ， 但 仅 有 少数 几 个 途径 可 以 编写 安全 的 代码 。 在 这 一 
章 中 ， 我 们 探讨 了 类 型 的 访问 控制 、 加 密 和 解密 、 安 全 地 存储 数据 、 编 程式 安全 和 声 
明 式 安全 等 领域 。 

第 12 章 线程 、 同 步 和 并 发 

这 一 章 的 主题 是 在 .NET 程序 中 使 用 多 个 执行 线程 ， 讨 论 的 问题 有 : 在 应 用 中 实现 多 线 
程 ， 避 免 资 源 的 并 行 访问 ， 人 允许 安 全 的 并 行 访问 ， 存 储 每 个 线程 的 数据 ， 顺 序 执行 任 
Z, TE .NET 中 使 用 同步 原 语 以 编写 线程 安全 的 代码 ， 等 等 。 

$133: 工具 箱 

这 一 章 包含 的 范例 是 开发 人 员 会 反复 遇 到 的 随机 操作 类 型 ， 例 如 确定 系统 资源 的 位 
置 ， 发 送 电子 邮件 ， 以 及 使 用 服务 。 这 一 章 还 包括 一 些 较 少 用 到 但 非常 有 用 的 应 用 程 
序 块 ， 如 消息 队列 ， 在 单独 的 应 用 程序 域 中 运行 代码 ， 以 及 在 全 局 程序 集 缓存 (global 
assembly cache, GAC) 中 查找 应 用 程序 集 的 版 本 。 



































有 一 些 范例 是 相关 联 的 ;在 这 类 范例 中 ， 参 阅 部 分 和 讨论 部 分 的 文本 中 会 广 明 这 些 关 联 
关系 o 


未 涉及 的 内 容 


这 本 书 并 不 是 C# 的 参考 手册 或 入 门 书 。O'Reilly 出 版 了 一 些 优 秀 的 入 门 书 和 参考 手册 ， 


如 
063 


do), 


sho 








Joseph Albahari 和 Ben Albahari 的 C# 6.0 in a Nutshell (http://shop.oreilly.com/product/ 
6920040323.do) 和 C# 6.0 Pocket Reference (http://shop.oreilly.com/product/0636920040675. 
以 及 Stephen Cleary 的 《C# 并 发 编程 经 典 实例 》 (Concurrency in C# Cookbook, http:// 
p.oreilly.com/product/0636920030171.do). MSDN 库 也 是 极为 有 用 的 。 它 包含 在 Visual 








Studio 2015 中 ， 也 可 以 在 网 站 http://msdn.microsoft.com 上 在 线 查看 。 


排版 约定 


在 本 书 中 将 会 使 用 以 下 排版 约定 。 








。 等 宽 字 体 (Constant width) 
用 于 程序 清单 和 代码 元 素 ， 如 命令 、 选 项 、 开 关 、 变 量 、 特 性 、 键 、 国 数 、 类 型 、 类 、 
命名 空间 、 APER 模块 、 属 性 、 参 数 、 值 、 对 象 、 事 件 、 事 件 处 理 器 、XML 标记 、 
HTML 标记 、 宏 、 文 件 的 内 容 和 命令 输出 。 


。 加 粗 等 宽 字体 (Constant width bold) 

用 于 在 程序 清单 中 突出 显示 代码 中 的 重要 部 分 。 
© 和 斜体 等 宽 字 体 (Constant width italic) 

用 于 指示 代码 中 可 替换 的 部 分 。 


。 Jla.. 
CH 代码 中 的 省 略 号 表示 为 了 段落 清晰 而 省 略 掉 的 文本 。 

















有 


在 XML 模式 和 文档 的 代码 中 的 省 略 号 表示 为 了 段落 清晰 而 省 略 掉 的 文本 。 


此 标志 指示 提示 、 建 议 或 一 般 注 意 事项 。 








关于 代码 

本 书 中 几乎 每 个 范例 都 包含 一 个 或 多 个 代码 示例 。 这 些 示例 包含 在 解决 方案 中 ， 代 码 片 段 
和 完整 项 目 都 可 以 直接 用 于 你 的 应 用 程序 。 大 多 数 代码 示例 都 写 在 一 个 类 或 结构 中 ， 使 得 
它们 更 易于 在 应 用 程序 中 使 用 。 除 此 之 外 ， 所 有 的 using 指令 都 包含 在 各 个 范例 中 ， 因 此 
你 不 需要 查 明 在 你 的 代码 中 要 包含 哪个 命名 空间 。 


只 有 关键 的 部 分 才 包 括 完整 的 错误 处 理 ， 例 如 输入 参数 。 这 允许 你 轻松 地 查看 什么 是 正确 
的 输入 ， 什么 是 错误 的 输入 。 许 多 范例 省 略 了 错误 处 理 ， 关 注重 点 概念 会 使 得 解决 方案 更 
易于 理解 。 


使 用 代码 示例 


这 本 书 的 示例 代码 可 从 网 页 https://github.com/oreillymedia/c_sharp_6_cookbook 上 获取 。 





























je | xv 


We 一 般 来 说 ， 你 可 以 在 自己 的 程序 和 文档 中 使 用 本 书 的 代 
。 你 没有 必要 联系 我 们 来 获得 授权 ， 除 非 想 对 代码 做 出 大 规模 的 重 构 。 比 如 ， 使 用 本 书 
pee eee 自己 的 代码 是 无 需 授 权 的 ， 但 是 销售 或 分 发 O'Reilly 出 版 书籍 配套 光 
盘 中 的 代码 是 需要 授权 的 ， 引 用 本 书 中 的 内 容 或 示例 代码 来 回答 问题 是 无 需 授 权 的， 而 把 
本 书 中 的 大 量 代码 合并 到 你 的 产品 文档 中 就 需要 授权 。 
我 们 并 不 要 求 你 注 明 引用 内 容 的 出 处 ， 但 是 非常 感激 你 这 么 做 。 一 条 引用 说 明 通 常 包括 
书 名 、 作 者 、 出 版 商 和 ISBN。 例 如 ,，“C# 6.0 Cookbook, Fourth Edition, by Jay Hilyard and 
Stephen Teilhet. Copyright ©2015 Jay Hilyard and Stephen Teilhet, 978-1-4919-2146-3”。 


如 果 你 感觉 你 使 用 代码 示例 的 方式 不 属于 以 上 所 述 的 任何 方式 ， 可 以 随时 与 我 们 联系 ， 我 
们 的 电子 邮箱 地 址 为 permissions@oreilly.com。 


Safar 在 线 图 书 


Safari 在 线 图 书 (http://safaribooksonline.com/) 是 一 个 基于 用 
Safa ri 户 需求 ， 发 行 全 球技 术 和 商业 领域 顶级 作者 的 优质 图 书 和 视频 
Books Online. (https://www.safaribooksonline.com/explore/) 的 数字 图 书馆 。 


技术 专家 、 软 件 开发 人 员 、 网 页 设计 师 以 及 商业 和 创意 专家 都 选择 将 Safari 在 线 图 书 作为 
研究 、 解 决 问题 、 学 习 和 证 书 培训 的 首要 资源 。 

Safari 在 线 图 书 为 企业 (https:Wwww.safaribooksonline.comy/enterprise/) 、 政 府 (https://www. 
safaribooksonline.com/government/)、 教 育 机 构 (https://www.safaribooksonline.com/academic- 


public-library/) 和 个 人 提供 了 不 同 的 产品 组 合 和 价格 方案 (https:/www.safaribooksonline.com/ 
pricing/) 。 
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用 户 可 通过 O'Reilly Media, Prentice Hall Professional, Addison-Wesley Professional, Microsoft 
Press, Sams, Que, Peachpit Press, Focal Press, Cisco Press, John Wiley & Sons, 
Syngress, Morgan Kaufmann, IBM Redbooks, Packt, Adobe Press, FT Press, Apress, 
Manning, New Riders, McGraw-Hill, Jones & Bartlett 和 Course Technology 等 poa eis 
商 的 数据 库 (https//www.safaribooksonline.com/our-library/) 搜寻 上 千 种 图 书 、 培 训 视 频 和 
预 出 版 的 手稿 。 要 了 解 有 关 Safari 在 线 图 书 的 更 多 信息 ， (http:// 


safaribooksonline.com/) , 


联系 我 们 
请 把 对 本 书 的 评价 和 问题 发 给 出 版 社 。 
美国 : 


O’Reilly Media, Inc. 
1005 Gravenstein Highway North 
Sebastopol, CA 95472 











中 国 : 


北京 市 西城 区 西直门 南大 街 2 号 成 铭 大 厦 C 座 807 (100035) 


奥 莱 利 技术 咨询 〈 北 京 ) 有 限 公 司 


O'Reilly 的 每 一 本 书 都 有 专属 网 页 ， 你 可 以 在 那儿 找到 本 书 的 相关 信息 ， 包 括 勘 误 表 、 示 





例 代码 以 及 其 他 信息 。 本 书 的 网 站 地 址 是 : 
http://shop.oreilly.com/product/0636920037347.do 


对 于 本 书 的 评论 和 技术 性 问题 ， 请 发 送 电子 邮件 到 : 


bookquestions@oreilly.com 








要 了 解 更 多 O'Reilly 图 书 、 培 训 课 程 、 会 议和 新 闻 的 信息 ， 请 访问 以 下 网 站 : 








http://www.oreilly.com 
我 们 在 Facebook 的 地 址 如 下 : http://facebook.com/oreilly 
请 关注 我 们 的 Twitter 动态 : http://twitter.com/oreillymedia 





我 们 的 YouTube 视频 地 址 如 下 : http:/www.youtube.com/oreillymedia 
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1.0 简介 


本 章 的 范例 洱 盖 了 C# 语言 的 基础 ， 主 题 包括 类 和 结构 ， 如 何 使 用 它们 ， 它 们 有 哪些 不 
同 ， 何 时 使 用 类 以 及 何 时 使 用 结构 。 在 此 基础 上 ， 我 们 将 构建 具有 各 种 固有 功能 〈 如 可 
排序 、 可 搜索 、 可 处 理 和 可 克隆 ) 的 类 。 此 外 ， 我 们 将 深入 讨论 联合 类 型 、 字 段 初 始 化 、 
lambda、 局 部 方法 、 单 路 和 多 路 广播 委托 、 闭 包 、 函 数 对 象 等 主题 。 本 章 也 包含 了 解析 命 
令 行 参数 的 范例 ， 这 是 开发 人 员 一 直 喜 爱 的 主题 。 

在 开始 展示 这 些 范 例 之 前 ， 让 我 们 回顾 一 下 关于 类 、 结 构 、 谤 型 的 面向 对 象 能 力 的 关键 信 
息 。 类 比 结 构 灵活 得 多 。 结 构 可 以 跟 类 一 样 实现 接口 ， 但 与 类 不 同 的 是 ， 它 们 不 能 继承 自 
类 或 结构 。 这 种 限制 使 得 你 无 法 创建 结构 层次 关系 ， 而 这 用 类 可 以 做 到 。 通 过 抽象 基 类 实 
现 的 多 态 性 也 是 在 结构 中 无 法 使 用 的 ， 因 为 除了 装 箱 成 0bject、ValueType 和 Enum， 结 构 
无 法 从 另 一 个 类 派生 。 


结构 与 其 他 的 值 类 型 一 样 ， 都 是 从 System. ValueType 隐 式 派生 的 。 竺 看 之 下 ， 结 构 类 似 于 
类 ， 但 它们 实际 上 有 很 大 的 差别 。 在 设计 应 用 程序 时 ， 知 道 何 时 使 用 结构 优 于 使 用 类 将 对 
你 有 很 大 的 帮助 。 不 正确 地 使 用 结构 可 能 会 使 代码 性 能 低下 、 难 以 修改 。 


结构 相对 于 引用 类 型 有 两 个 性 能 优势 。 首 先 ， 如 果 一 个 结构 是 在 栈 上 分 配 的 〈 即 不 包含 在 
引用 类 型 内 ) ， 访 问 结构 及 其 数据 的 速度 要 快 于 访问 堆 中 引用 类 型 的 速度 。 


引用 类 型 的 对 象 必须 要 跟随 它 在 堆 上 的 引用 以 获取 它们 的 数据 。 不 过 ， 这 种 性 能 优势 相对 
于 结构 的 第 二 个 性 能 优势 就 相形 见 红 了 : 要 清理 在 栈 上 为 结构 分 配 的 内 存 ， 只 需要 在 方法 
调用 返回 时 修改 栈 指针 所 指向 的 地 址 即 可 。 这 个 调用 要 远 远 快 于 垃圾 回收 器 自动 清理 托管 
堆 上 分 配 的 引用 类 型 。 然 而 垃圾 回收 器 的 成 本 是 延 后 的 ， 所 以 不 会 立刻 被 人 注意 到 。 




































































当 以 传 值 方式 传人 其 他 方法 时 ， 结 构 的 性 能 就 比 不 上 类 了 。 因 为 结构 存在 于 栈 上 ， 当 以 传 
值 方式 传人 一 个 方法 时 ， 结 构 及 其 数据 必须 复制 到 一 个 新 的 局 部 变量 (方法 用 于 接收 结构 
的 参数 ) 中 。 这 一 复制 过 程 相 比 将 一 个 引用 传人 方法 要 花费 更 多 的 时 间 ， 除 非 结 构 的 大 小 
与 机 器 的 指针 大 小 相同 或 更 小 一 些 ， 因 此 ， 在 32 位 的 机 器 上 ， 传 入 一 个 32 位 大 小 的 结构 
与 传 入 一 个 引用 (与 指针 大 小 相同 ) 的 成 本 是 相同 的 。 在 类 和 结构 之 间 选 择 时 ， 要 记得 这 
一 点 。 尽 管 创建 、 访 问 和 销毁 类 对 象 可 能 需要 更 长 时 间 ， 但 并 不 能 抵消 将 结构 多 次 按 值 传 
入 一 个 或 多 个 方法 产生 的 性 能 下 降 。 保 持 较 小 的 结构 体 可 以 减 小 按 值 传递 时 所 产生 的 性 能 
下 降 。 

以 下 情况 应 使 用 类 。 


。 其 同一 性 很 重要 。 结 构 在 按 值 传人 方法 时 会 被 隐 式 复制 。 

。 有 较 大 的 内 存 占用 。 

。 其 字段 需要 初始 化 。 

。 需要 从 一 个 基 类 继承 。 

。 需要 多 态 行为 ; 也 就 是 说 , 你 需要 实现 一 个 抽象 基 类 , 并 从 此 基 类 派生 出 多 个 相似 的 类 。 
(注意 ， 多 态 性 也 可 以 通过 接口 实现 ， 但 通常 并 不 适合 在 一 个 值 类 型 中 实现 接口 。 这 是 
因为 当 结 构 转换 为 接口 时 ， 会 因 装 箱 操 作 而 导致 性 能 损失 。) 


以 下 情况 应 使 用 结构 。 


。 其 行为 方式 类 似 于 原 语 类 型 (int, long, byte 等 ) 。 

。 仅 占 用 较 小 的 内 存 。 

。 调用 一 个 需要 将 结构 体 以 传 值 方式 传人 的 P/Invoke 方法 。 平 台 调 用 (Platform Invoke， 
P/Invoke) 允许 托管 代码 调用 DLL 内 公开 的 非 托管 方法 。 许 多 时 候 ， 非 托管 DLL 内 的 
方法 都 需要 传 和 一 个 结构 参数 。 使 用 结构 是 执行 此 操作 的 一 种 高 效 方法 ， 并 且 在 需要 按 
值 传 入 时 是 唯一 的 途径 。 

。 需要 降低 垃圾 回收 对 应 用 程序 性 能 的 影响 。 

。 其 字段 只 需要 被 初始 化 为 默认 值 。 对 于 数值 类 型 ， 这 个 值 为 6; 对 于 布尔 类 型 ， 则 为 
false, 对 于 引用 类 型 , 则 为 null, ERE C# 6.0 中 , 结构 可 以 拥有 默认 构造 国 数 并 将 字 
段 初始 化 为 非 默 认 值 。 

。 不 需要 继承 一 个 基 类 (BRT ValueType 之 外 ， 所 有 结构 都 继承 它 ) 。 

。 不 需要 多 态 行为 。 


当 把 结构 传递 给 需要 一 个 对 象 参 数 的 方法 时 ， 例 如 Framework X (FCL) 中 的 任何 非 泛 
型 集合 类 型 ， 它 们 也 可 能 会 引起 性 能 降低 。 把 一 个 结构 (对 此 问题 而 言 其 实 是 任何 简单 类 
型 ) 传人 一 个 需要 对 象 参数 的 方法 中 将 会 导致 结构 被 装 箱 。 装 箱 (boxing) 是 指 将 一 个 值 
类 型 包装 在 一 个 对 象 中 。 这 种 操作 比较 耗 时 ， 并 且 可 能 导致 性 能 降低 。 

最 后 ， 将 泛 型 功能 加 入 进来 就 能 够 编写 类 型 安全 且 高 效 的 基于 集合 和 模式 的 代码 了 。 
泛 型 提供 相当 强大 的 编程 能 力 ， 但 是 要 求 你 正确 使 用 它 。 如 果 你 考虑 把 ArrayList、 
Queue, Stack 和 Hashtable 对 象 转换 成 其 对 应 的 泛 型 对 象 ， 可 以 阅读 一 下 1.9 节 和 1.10 
节 中 的 范例 。 你 将 看 到 这 种 转换 并 非 总 是 很 简单 ， 有 一 些 原因 可 能 导致 你 根本 不 想 执行 
这 种 转换 。 














































































































2 | 第 1 章 


1.1 


1.1.1 


创建 联合 类 型 的 结构 


问题 





你 需要 创建 一 种 数据 类 型 ， 其 行为 方式 类 似 于 C++ 中 的 联合 类 型 。 联 合 类 型 主要 用 于 互 操 


作 场 景 
用 它 。 








1.1.2 ”解决 方案 


使 用 一 个 结构 ， 并 用 StructLayout 特性 标记 它 (在 构造 函数 中 指定 LayoutKind. Explicit 
布局 类 型 )。 此 外 ， 利 用 Fieldoffset 特性 标记 结构 中 的 每 个 字段 。 下 面 的 结构 定义 了 一 个 


联合 类 














回 一 个 联合 类 型 ， 我 们 建议 你 不 要 在 其 他 情况 下 使 





其 中 非 托管 代码 接受 和 /或 返 
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型 ， 其 中 可 以 存储 一 个 带 符 号 数值 。 


using System.Runtime.IteropServices; 
[StructLayoutAttribute(LayoutKind.Explicit)] 
struct SignedNumber 


( 


j 


[FieldOffsetAttribute(0)] 
public sbyte Numi; 
[FieldOffsetAttribute(0)] 
public short Num2; 
[FieldOffsetAttribute(0)] 
public int Num3; 
[FieldOffsetAttribute(0)] 
public long Num4; 
[FieldOffsetAttribute(0)] 
public float Num5; 
[FieldOffsetAttribute(0)] 
public double Num6; 








下 一 个 结构 类 似 于 SignedNumber 结构 ， 不 同 之 处 是 除了 带 符号 的 数值 之 外 ， 它 还 可 以 包含 
String 类 型 。 


[StructLayoutAttribute(LayoutKind.Explicit)] 
struct SignedNumberWithText 


( 


[FieldOffsetAttribute(0)] 
public sbyte Numi; 
[FieldOffsetAttribute(0)] 
public short Num2; 
[FieldOffsetAttribute(0)] 
public int Num3; 
[FieldOffsetAttribute(0)] 
public long Num4; 
[FieldOffsetAttribute(0)] 
public float Num5; 
[FieldOffsetAttribute(0)] 
public double Num6; 
[FieldOffsetAttribute(16)] 





public string Text1; 


} 


1.1.3 Wit 

联合 类 型 是 一 种 在 C++ 代码 中 较为 常见 的 结构 类 型 ， 不 过 ， 有 一 种 方式 可 以 使 用 C# 中 的 
结构 数据 类 型 来 复制 其 结构 。 联 合 (union) 是 一 种 结构 ， 在 内 存 中 的 特定 位 置 为 该 结构 接 
受 多 种 类 型 。 例 如 ，SignedNumber 结构 是 使 用 CH 结构 创建 的 一 个 联合 类 型 的 结构 。 这 种 
结构 可 以 接受 任何 类 型 的 带 符号 的 数值 类 型 (sbyte、int 和 long 4), 但 它 只 在 结构 中 的 
同一 个 位 置 (同一 偏 移 量 ) 接受 这 种 数字 类 型 。 








由 于 StructLayoutAttribute 可 以 同时 应 用 于 结构 和 类 ， 在 创建 联合 数据 类 
型 时 也 可 以 使 用 类 。 





注意 FieldoffsetAttribute 将 值 0 传递 给 它 的 构造 函数 。 这 表明 这 个 字段 距离 结构 开始 处 
的 偏 移 量 为 0 字 节 。 可 以 将 这 个 特性 与 StructLayoutAttribute 结合 使 用 ， 手 动 强制 指定 
结构 中 的 字段 开始 于 什么 位 置 ( 即 每 个 字段 在 内 存 中 相对 于 这 个 结构 开始 处 的 偏 移 量 )。 
FieldOffsetAttribute 只 能 与 设置 为 LayoutKind.Explicit 的 StructLayoutAttribute 一 起 
使 用 。 此 外 ， 它 不 能 用 于 结构 内 的 静态 成 员 。 

联合 类 型 可 能 会 带 来 一 些 问题 ， 因 为 几 种 类 型 实质 上 是 相互 合 加 在 一 起 的 。 最 大 的 问题 是 
如 何 从 联合 类 型 结构 中 提取 正确 的 数据 类 型 。 思 考 一 下 ， 如 果 你 选择 在 SignedNumber 结 
构 中 存储 Long 数值 类 型 的 值 long.MaxValue， 会 发 生 什么 情况 。 随 后 ， 你 可 能 会 偶然 尝试 
从 这 个 结构 中 提取 一 个 byte 数据 类 型 值 。 这 样 操作 ， 你 将 会 只 取 回 这 个 Long 值 中 的 第 一 
字 市 。 

男 一 个 问题 是 在 正确 的 偏 移 位 置 开始 字段 。SignedNumberwithText 联合 类 型 在 偏 移 量 为 0 
的 位 置 全 加 了 大 量 带 符号 的 数值 数据 类 型 。 这 个 结构 中 的 最 后 一 个 字段 位 于 内 存 中 距离 这 
个 结构 开始 处 偏 移 量 为 16 字 节 的 位 置 。 如 果 你 意外 地 把 字符 串 字段 Text1 覆盖 在 任何 其 他 
带 符 号 的 数值 数据 类 型 之 上 ， 在 运行 时 将 得 到 一 个 异常 。 基 本 规则 是 : 允许 你 把 一 种 值 类 
型 登 加 在 另 一 种 值 类 型 之 上 ,但 是 不 能 把 一 种 引用 类 型 全 加 于 一 种 值 类 型 之 上 。 如 果 用 以 
下 特性 标记 Text1 字段 : 


[FieldOffsetAttribute(14)] 
就 会 在 运行 时 引发 下 面 这 个 异常 (注意 ， 编 译 器 不 会 捕获 这 个 问题 )。 


System.TypeLoadException: Could not load type 'SignedNumberWithText' from 
assembly 'CSharpRecipes, Version-1.0.0.0, Culture=neutral, 
PublicKeyToken-fe85c3941fbcc4c5' because it contains an object field at 
offset 14 that is incorrectly aligned or overlapped by a non-object field. 


在 C# 中 使 用 复杂 的 联合 类 型 时 ， 必 须 保证 正确 的 偏 移 量 。 





























11.4 参考 


MSDN 文档 中 的 “StructLayoutAttribute 类 ”主题 。 


1.2 ”使 类 型 可 排序 


1.2.1 问题 





你 有 一 种 数据 类 型 ， 它 将 存储 为 List<T> 或 SortedList<K,V> 的 元 素 。 你 想 使 用 List<T>. 
Sort 方法 或 者 SortedList<K,V> 的 内 部 排序 机 制 来 自 定 义 此 数据 类 型 在 数组 中 的 排序 方式 。 


此 外 ， 你 可 能 需要 在 SortedList 集合 中 使 用 这 种 类 型 。 


1.2.2 ”解决 方案 





例 1-1 演示 了 如 何 实现 IComparable<T> 接口 。 例 1-1 中 展示 的 Square 类 实现 了 这 个 接口 ， 





使 得 List«T» 和 SortedList<K,V> 集合 能 够 排序 和 查找 这 些 Square 对 象 。 


例 1-1: 通过 实现 IComparable«T» 使 类 型 可 排序 
public class Square : IComparable<Square> 


{ 
public Square(){} 


public Square(int height, int width) 
{ 

this.Height = height; 

this.Width = width; 
} 
public int Height { get; set; } 
public int Width { get; set; } 


public int CompareTo(object obj) 


{ 

Square square = obj as Square; 

if (square != null) 

return CompareTo(square); 
throw 
new ArgumentException( 
"Both objects being compared must be of type Square."); 

} 


public override string ToString()=> 


(S"Height: {this.Height} Width: {this.Width}"); 


public override bool Equals(object obj) 


t 
if (obj == null) 
return false; 





1.2.3 


通过 在 类 (或 结构 ) 上 实现 IComparabtLe<T> 接口 
类 的 排序 例 程 。 排 序 算法 内 置 在 这 些 类 中 ， 你 只 需要 


Square square = obj as Square; 
if(square != null) 


return this.Height == square.Height; 
return false; 
} 
public override int GetHashCode( ) 
{ 
return this.Height.GetHashCode() | this.Width.GetHashCode(); 
} 
public static bool operator ==(Square x, Square y) => x.Equals(y); 
public static bool operator !=(Square x, Square y) => !(x == y); 
public static bool operator <(Square x, Square y) => (x.CompareTo(y) < 0); 
public static bool operator >(Square x, Square y) => (x.CompareTo(y) > 0); 
public int CompareTo(Square other) 
{ 
long areal = this.Height * this.Width; 
long area2 = other.Height * other.Width; 
if (area1 == area2) 
return 0; 
else if (areal > area2) 
return 1; 
else if (areal < area2) 
return -1; 
else 
return -1; 
} 
* + 
讨论 





法 中 实现 的 代码 告诉 它们 如 何 对 你 的 类 进行 排序 即 可 。 


当 调 月 





， 就 可 以 利用 List<T> 和 SortedList<K,V> 
通过 在 IComparabLe<T>.CompareTo 77 


H List<Square>.Sort 方法 对 Square 对 象 的 列表 进行 排序 时 ， 列 表 是 通过 Square 


对 象 的 IComparable«Square» 接口 进行 排序 的 。 当 把 对 象 添加 到 SortedList«K,v» 中 时 ， 
SortedList<K,V> 类 的 Add 方法 使 用 这 个 接口 对 它们 进行 排序 。 


rer<T> 设计 用 于 解决 如 下 问题 


序 。 


{ 


个 接口 还 允许 你 对 其 他 人 编 写 的 类 型 进 和 人 排序。 如果 你 还 
nares 就 可 以 创建 一 个 名 为 CompareHeight 的 新 类 ， 如 例 1-2 中 所 示 。 它 也 实现 了 
IComparer<Square> 接口 。 


例 1-2: 通过 实现 IComparer 使 类 型 可 排序 


public class CompareHeight : IComparer<Square> 











: 允许 基于 不 同 环境 中 的 不 同 标准 对 对 象 进行 排 


\ 想 按 高 度 对 Square 对 象 





public int Compare(object firstSquare, object secondSquare) 





Square square1 = firstSquare as Square; 
Square square2 = secondSquare as Square; 
if (square1 == null || square2 == null) 
throw (new ArgumentException("Both parameters must be of type Square.")); 


else 


return Compare(firstSquare,secondSquare); 


} 


#region IComparer<Square> Members 


public int Compare(Square x, Square y) 


{ 


if (x.Height == y.Height) 


return 


else if (x. 


return 


else if (x. 


return 
else 
return 


} 


#endregion 


} 


0; 
Height » y.Height) 
1; 
Height < y.Height) 
-1; 


-1; 


然后 将 这 个 类 传人 Sort 方法 的 IComparer 参数 。 现 在 你 可 以 指定 以 不 同 的 方式 对 Square 
对 象 进行 排序 。 比 较 器 中 实现 的 比较 方法 必须 保持 一 致 并 应 用 全 局 排序 ， 从 而 使 得 比较 国 
数 声明 两 个 数据 项 相等 时 绝对 正确 ， 而 不 是 以 下 情况 的 结果 : 一 个 数据 项 不 大 于 另 一 个 数 
据 项 或 者 一 个 数据 项 不 小 于 另 一 个 数据 项 。 








为 了 获得 最 佳 性 能 ， 需 要 保持 CompareTo 方法 短小 、 高 效 ， 因 为 它 将 被 sort 
方法 调用 多 次 。 例 如 ， 在 对 含有 4 个 数据 项 的 数组 排序 时 ，Compare 方法 将 
被 调用 10 次。 














例 1-3 中 展示 的 TestSort 方法 演示 了 如 何 对 List<Square> 和 SortedList<int,Square> 实例 
使 用 Square 和 CompareHeight 类 。 


例 1-3: TestSort 方法 
public static void 


{ 


TestSort() 


List<Square> listOfSquares = new List<Square>(){ 


new Square(1,3), 
new Square(4,3), 
new Square(2,1), 
new Square(6,1)}; 


// 测试 List<String> 
Console.WriteLine("List<String>"); 
Console.WriteLine("Original list"); 
foreach (Square square in listOfSquares) 
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j 


{ 
j 


Console.WriteLine(square.ToString()); 


Console.WriteLine(); 

IComparer«Square» heightCompare - new CompareHeight(); 
listOfSquares.Sort(heightCompare); 

Console.WriteLine("Sorted list using IComparer«Square»-heightCompare"); 
foreach (Square square in listOfSquares) 


{ 
j 


Console.WriteLine(square.ToString()); 


Console.WriteLine(); 

Console.WriteLine("Sorted list using IComparable<Square>"); 
listOfSquares.Sort(); 

foreach (Square square in listOfSquares) 


t 
j 


Console.WriteLine(square.ToString()); 


// 测试 sortedList 

var sortedListOfSquares = new SortedList<int,Square>(){ 
{ 0, new Square(1,3)}, 

{ 2, new Square(3,3)}, 

{ 1, new Square(2,1)}, 

{ 3, new Square(6,1)}}; 
Console.WriteLine(); 

Console.WriteLine(); 

Console.WriteLine("SortedList<Square>"); 

foreach (KeyValuePair<int,Square> kvp in sortedListOfSquares) 


t 
j 


Console.WriteLine ($"{kvp.Key} : {kvp.Value}"); 





这 些 代码 的 输出 如 下 所 示 。 


List<String> 
Original list 
Height:1 Width:3 
Height:4 Width:3 
Height:2 Width:1 
Height:6 Width:1 


Sorted list using IComparer<Square>=heightCompare 
Height:1 Width:3 
Height:2 Width:1 
Height:4 Width:3 
Height:6 Width:1 


Sorted list using IComparable<Square> 
Height:2 Width:1 
Height:1 Width:3 





Height:6 Width:1 
Height:4 Width:3 


SortedList<Square> 

0 : Height:1 Width:3 
1 : Height:2 Width:1 
2 : Height:3 Width:3 
3 : Height:6 Width:1 


1.24 ”参考 
范例 1.3 (BN 1.345) ; MSDN 文档 中 的 “IComparable<T> 接口 ”主题 。 


1.8 ”使 类 型 可 查找 


1.3.1 问题 


你 有 一 种 数据 类 型 ， 它 将 存储 为 List<T> 中 的 元 素 。 你 想 使 用 BinarySearch 方法 ， 自 定义 
你 的 数据 类 型 在 列表 中 的 查找 方式 。 


1.3.2 ”解决 方案 


使 用 IComparabLe<T> 和 IComparer<T> 接口 。 范 例 1.2 ( 即 1.2 节 ) 中 的 Square 类 实现 了 
IComparable<T> 接口 ， 使 得 List<T> 和 SortedList<K,V> 集合 可 以 排序 和 查找 Square 对 象 
的 数组 和 集合 。 


1.3.3 讨论 

通过 在 类 (或 结构 ) 上 实现 Icomparable<T> 接口 ， 就 可 以 利用 List<T> 和 SortedList<K,V> 
类 的 排序 例 程 。 排 序 算法 内 置 在 这 些 类 中 ， 你 只 需要 通过 在 IComparable«T».CompareTo 7j 
法 中 实现 的 代码 告诉 它们 如 何 对 你 的 类 进行 排序 即 可 。 

要 实现 CompareTo 方法 ， 请 参考 范例 1.2 (BI 1.2 节 )。 


List<T> 类 提供 了 一 个 BinarySearch 方法 来 查找 该 列表 中 的 元 素 。 列 表 中 的 元 素 会 与 传递 
给 对 象 参数 中 的 BinarySearch 方法 的 某 个 对 象 进 行 比较 。SortedList 类 没有 BinarySearch 
方法 ， 作 为 替代 ， 它 拥有 Containskey 方法 ， 用 于 对 列表 中 包含 的 键 值 执行 二 分 查 
1€, SortedList 类 的 ContainsValue 方法 在 查找 值 时 执行 线性 查找 。 这 种 线性 查找 使 用 
SortedList 集合 中 的 元 素 的 Equals 方法 来 执行 其 工作 。Compare 和 CompareTo 方法 对 于 
SortedList 类 中 执行 的 线性 查找 不 起 任何 作用 ， 但 是 它们 确实 会 影响 二 分 查找 。 


为 了 使 用 List<T> 类 的 BinarySearch 方法 执行 准确 的 查找 ， 首 先 必须 使 用 
List<T> 的 Sort 方法 对 其 进行 排序 。 此 外 ， 如 果 把 一 个 IComparer<T> 接口 
传 入 给 BinarySearch 方法 ， 还 必须 把 相同 的 接口 传递 给 sort 方 法。 否则 ， 
BinarySearch 方法 也 许 无 法 找到 你 正在 寻找 的 对 象 。 



































例 1-4 中 的 TestSort 方法 演示 了 如 何 对 List<Square> 和 SortedList<int, Square> 集合 实例 
使 用 Square 和 CompareHeight 类 。 


例 1-4: 使 类 型 可 查找 
public static void TestSearch() 


{ 

List<Square> listOfSquares = new List<Square> {new Square(1,3), 
new Square(4,3), 
new Square(2,1), 
new Square(6,1)}; 


IComparer<Square> heightCompare = new CompareHeight(); 


// 测试 List<Square> 
Console.WriteLine("List«Square»"); 
Console.WriteLine("Original list"); 
foreach (Square square in listOfSquares) 


{ 
j 


Console.WriteLine(square.ToString()); 


Console.WriteLine(); 

Console.WriteLine("Sorted list using IComparer«Square»-heightCompare"); 
listOfSquares.Sort(heightCompare); 

foreach (Square square in listOfSquares) 


{ 
j 


Console.WriteLine(square.ToString()); 


Console.WriteLine(); 

Console.WriteLine("Search using IComparer<Square>=heightCompare") ; 

int found = listOfSquares.BinarySearch(new Square(1,3), heightCompare); 
Console.WriteLine($"Found (1,3): {found}"); 


Console.WriteLine(); 

Console.WriteLine("Sorted list using IComparable<Square>"); 
listOfSquares.Sort(); 

foreach (Square square in listOfSquares) 


{ 
j 


Console.WriteLine(square.ToString()); 


Console.WriteLine(); 

Console.WriteLine("Search using IComparable«Square»"); 

found = listOfSquares.BinarySearch(new Square(6,1)); // 使 用 IComparable 
Console.WriteLine($"Found (6,1): {found}"); 














// 测试 sortedList<Square> 
var sortedListOfSquares = new SortedList<int, Square>(){ 
(0, new Square(1,3)}, 
(2, new Square(4,3)}, 
(1, new Square(2,1)}, 
{4, new Square(6,1)}}; 
Console.WriteLine(); 





Console.WriteLine("SortedList<Square>") ; 
foreach (KeyValuePair<int,Square> kvp in sortedListOfSquares) 


{ 
j 


Console.WriteLine ($"{kvp.Key} : {kvp.Value}"); 


Console.WriteLine(); 
bool foundItem = sortedListOfSquares.ContainsKey(2); 
Console.WriteLine(S"sortedListOfSquares.ContainsKey(2): {foundItem}"); 








// 不 要 使 用 IComparer 和 IComparable 

// -- 使 用 未 重 写 过 的 Equals 方 法 实现 线性 查找 

Console.WriteLine(); 

Square value - new Square(6,1); 

foundItem - sortedListOfSquares.ContainsValue(value); 

Console.WriteLine("sortedListOfSquares.ContainsValue 
$"(new Square(6,1)): {foundItem}"); 











+ 


} 
这 段 代 码 显 示 的 结果 如 下 所 示 。 


List<Square> 
Original list 
Height:1 Width:3 
Height:4 Width:3 
Height:2 Width:1 
Height:6 Width:1 


Sorted list using IComparer<Square>=heightCompare 
Height:1 Width:3 
Height:2 Width:1 
Height:4 Width:3 
Height:6 Width:1 


Search using IComparer<Square>=heightCompare 
Found (1,3): 0 


Sorted list using IComparable<Square> 
Height:2 Width:1 
Height:1 Width:3 
Height:6 Width:1 
Height:4 Width:3 


Search using IComparable<Square> 
Found (6,1): 2 


SortedList<Square> 

0 : Height:1 Width:3 
1 : Height:2 Width:1 
2 : Height:4 Width:3 
4 : Height:6 Width:1 


sortedListOfSquares.ContainsKey(2): True 
sortedListOfSquares.ContainsValue(new Square(6,1)): True 
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13.4 ”参考 


范例 12 (BI 1.249) ; MSDN 文档 中 的 “IComparabLe<T> 接口 ”和 “IComparer<T> 接口 ” 
主题 。 


1.4 从 一 个 方法 返回 多 个 数据 项 


1.4.1 问题 


在 许多 情况 下 ， 从 一 个 方法 返回 一 个 值 是 不 够 的 。 你 需要 一 种 方式 来 从 一 个 方法 返回 不 止 
一 个 数据 项 。 


1.4.2 解决 方案 
对 充当 返回 参数 的 参数 使 用 关键 字 out。 下 面 的 方法 接受 一 个 inputShape 参数 ， 并 通过 该 
值 计 算 height, width 和 depth, 
public void ReturnDimensions(int inputShape, 
out int height, 


out int width, 
out int depth) 




















{ 

height = 0; 

width = 0; 

depth = 0; 

// 通过 inputShape 值 计算 hetight .width 和 depth 
} 


这 个 方法 以 如 下 方式 进行 调用 : 


// 声明 输出 参数 
int height; 
int width; 
int depth; 


// 调用 方法 并 返回 height、width 和 depth 
0bj.ReturnDimensions(1, out height, out width, out depth); 


另 一 个 方法 将 返回 一 个 包含 所 有 返回 值 的 类 或 结构 。 修 改 前 一 个 方法 ， 使 其 返回 一 个 结 
构 ， 而 不 是 使 用 out 参数 : 


public Dimensions ReturnDimensions(int inputShape) 






































{ 
// 默认 构造 函数 自动 将 结构 的 成 员 初 始 化 为 0 
Dimensions objDim = new Dimensions(); 
// 通过 inputShape 的 值 计算 objDim.Height、objDim.Width、objDim.Depth…… 
return objDim; 
} 





其 中 Dimensions 的 定义 如 下 所 示 。 


public struct Dimensions 


{ 
public int Height; 
public int Width; 
public int Depth; 
} 


现在 以 如 下 方式 调用 这 个 方法 。 


// 调用 方法 并 且 返 回 hetight .width 和 depth 
Dimensions objDim = obj.ReturnDimensions(1); 


除了 从 此 方法 返回 一 个 用 户 定义 的 类 或 结构 ， 也 可 以 用 一 个 Tuple 对 象 包含 所 有 的 返回 值 。 
修改 前 一 个 方法 ， 使 其 返回 一 个 Tuple, 


public Tuple<int, int, int> ReturnDimensionsAsTuple(int inputShape) 















































{ 
// 通过 inputShape 值 计算 objDim.Height、.objDim.Wtdth objDim. Depth 
// 例如 {5，190，15} 
// 创建 一 个 包含 计算 出 的 值 的 Tuple 
var objDim = Tuple.Create<int, int, int>(5, 10, 15); 
return (objDim); 
} 


现在 以 如 下 方式 调用 这 个 方法 。 


// 调用 方法 并 且 返 回 height .width 和 depth 
Tuple<int, int, int» objDim = obj.ReturnDimensions(1); 






































1.4.3 讨论 

在 方法 签名 中 使 用 out 关键 字 创 建 一 个 参数 ， 指 示 这 个 参数 将 由 该 方法 初始 化 并 返回 。 当 
需要 方法 返回 多 个 值 时 ， 这 个 技巧 就 很 有 用 。 一 个 方法 最 多 只 能 有 一 个 返回 值 ， 但 是 通过 
使 用 out 关键 字 ， 可 以 把 多 个 参数 标记 为 一 个 返回 值 。 


要 设置 一 个 out 参数 ， 需 要 用 out 关键 字 标 记 方 法 签名 中 的 参数 ， 如 下 所 示 。 


public void ReturnDimensions(int inputShape, 
out int height, 
out int width, 
out int depth) 














{ 
} 
要 调用 这 个 方法 ， 还 必须 用 out 关键 字 标记 调用 方法 的 参数 ， 如 下 所 示 。 


obj.ReturnDimensions(1, out height, out width, out depth); 


这 个 方法 中 的 out 参数 不 必 和 初始 化 ， 只 需 声明 它们 并 传 入 ReturnDimensions 方法 中 即 可 。 
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不 管 在 调用 方法 之 前 是 否 初 始 化 过 它们 ， 在 ReturnDimensions 方法 内 使 用 它们 之 前 都 必须 
初始 化 。 即 使 不 通过 ReturnDimensions 方法 内 的 每 条 路 径 使 用 它们 ， 仍然 必 须 初 始 化 它 
们 。 这 就 是 这 个 方法 以 如 下 三 行 代码 开始 的 原因 。 








height = 0; 
width = 0; 
depth = 0; 


你 可 能 想 知道 为 什么 不 能 使 用 ref 参数 代替 out 参数 ， 鉴 于 它们 都 允许 一 个 方法 改变 像 这 
样 标记 的 参数 的 值 。 答 案 是 ，out 参数 使 代码 有 些 自 文档 化 。 当 遇 到 一 个 out 参数 时 ， 你 
知道 这 个 参数 充当 一 个 返回 值 。 此 外 ， 在 把 out 参数 传人 方法 中 之 前 ， 不 需要 做 额外 的 工 
作 来 初始 化 它 ， 而 ref 参数 则 需要 这 样 做 。 


在 调用 方法 时 不 需要 对 out 参数 进行 封 送 ， 相反， 在 方法 把 数据 返回 给 调用 
者 时 对 其 封 送 一 次 。 任 何其 他 调用 类 型 ( 按 值 调用 或 者 使 用 ref 关键 字 按 引 
用 调用 ) 都 要 求 在 两 个 方向 上 对 值 进 行 封 送 。 在 封 送 场 合 下 使 用 out REF 
可 以 改进 远程 调用 性 能 。 















































在 仅 有 少量 值 需要 返回 时 ，out 参数 是 非常 有 用 的 ， 但 是 当 你 遇 到 需要 返回 4 个 、5 个 、6 
个 其 至 更 多 的 值 时 ， 它 就 变 得 笨重 了 。 另 外 一 个 返回 多 个 值 的 选项 是 创建 并 返回 用 户 定义 
的 类 或 结构 ， 或 者 使 用 Tuple 打包 需要 由 某 个 方法 返回 的 所 有 值 。 

使 用 类 或 结构 返回 多 个 值 的 第 一 个 选项 非常 直接 。 只 需要 像 下 面 这 样 创建 类 型 (在 本 例 中 
是 该 类 型 是 一 个 结构 ) 即 可 。 


public struct Dimensions 








public int Height; 

public int Width; 

public int Depth; 
} 


如 1.4.2 节 所 展示 的 ， 将 需要 的 数据 填充 到 这 个 数据 结构 的 每 个 字段 中 ， 并 且 从 方法 中 返 
回 它 。 
与 使 用 用 户 定义 的 对 象 相 比 ， 使 用 Tuple 的 第 二 个 选项 更 加 简洁 。 可 以 创建 一 个 Tuple, 
用 于 包含 不 同类 型 的 任意 数量 的 值 。 此 外 ，Tuple 中 保存 的 数据 是 不 可 变 的 ， 一 旦 通过 构 
a AMA ASH Create 方法 将 数据 添加 到 Tuple 中 ， 就 无 法 再 修改 这 些 数据 了 。 
Tuple 可 以 接受 并 包含 8 个 独立 的 值 。 如 里 你 需要 8 个 以 上 的 值 ， 那 么 需要 使 用 这 个 特别 
的 Tuple 类 。 

Tuple<T1, T2, T3, T4, T5, T6, T7, TRest> Class 
当 创 建 一 个 包含 超过 8 MAM Tuple 时 ， 你 无 法 使 用 静态 的 Create 方法 ， 而 是 必须 使 用 
Tuple 类 的 构造 函数 。 下 面 的 代码 展示 了 如 何 创建 一 个 包含 10 个 整数 值 的 Tuple, 


var values = new Tuple<int, int, int, int, int, int, int, Tuple<int, int, int>> ( 
1, 2, 3, 4, 5, 6, 7, new Tuple<int, int, int> (8, 9, 10)); 





当然 ， 你 可 以 继续 将 更 多 的 Tuple s Jn a7 ARRAY Tuple 类 的 最 后 ， 以 创建 你 需要 的 任 
何 大 小 的 Tuple。 


1.44 参考 


MSDN 文档 中 的 “Tuple 2E” fj “Tuple<T1, T2, T3, T4, T5, T6, T7, TRest> 类 ”主题 。 


1.5 ”解析 命令 行 参数 


1.5.1 问题 
你 需要 应 用 程序 以 标准 格式 (在 1.5.3 节 中 介绍 ) 接受 一 个 或 多 个 命令 行 参数 。 你 需要 访 
问 和 解析 传递 给 应 用 程序 的 完整 命令 和 


1.5.2 ”解决 方案 


在 例 1-5 中 ， 结 合 使 用 以 下 类 来 帮 你 解析 命令 行 参数 : Argument, ArgumentDefinition 和 
ArgumentSemanticAnalyzer, 











4 
S 








例 1-5: Argument 类 
using System; 
using System.Diagnostics; 
using System.Linq; 
using System.Collections.ObjectModel; 


public sealed class Argument 
{ 
public string Original { get; } 
public string Switch { get; private set; } 
public ReadOnlyCollection<string> SubArguments { get; } 
private List<string> subArguments; 
public Argument(string original) 
{ 
Original = original; 
Switch = string.Empty; 
subArguments = new List<string>(); 
SubArguments = new ReadOnlyCollection<string>(subArguments) ; 
Parse(); 


} 


private void Parse() 


{ 
if (string.IsNullOrEmpty(Original)) 


{ 


} 
char[] switchChars = { '/', '-' }; 
if (!switchChars.Contains(Original[0])) 


return; 


{ 
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return; 


j 


string switchString - Original.Substring(1); 

string subArgsString - string.Empty; 

int colon = switchString.IndexOf(':'); 

if (colon >= 0) 

{ 
subArgsString = switchString.Substring(colon + 1); 
switchString = switchString.Substring(0, colon); 

} 

Switch = switchString; 

if (!string.IsNullOrEmpty(subArgsString)) 
subArguments.AddRange(subArgsString.Split(';')); 

} 


// 一 组 谓词 ,提供 关于 参数 的 有 用 信息 
// 使 用 Lambda 表 达 式 实现 
public bool IsSimple => SubArguments.Count == 0; 
public bool IsSimpleSwitch => 

Istring.IsNullOrEmpty(Switch) && SubArguments.Count == 0; 
public bool IsCompoundSwitch => 

Istring.IsNullOrEmpty(Switch) && SubArguments.Count == 1; 
public bool IsComplexSwitch => 

!string.IsNullOrEmpty(Switch) && SubArguments.Count > 0; 

} 


public sealed class ArgumentDefinition 
{ 
public string ArgumentSwitch { get; } 
public string Syntax { get; } 
public string Description { get; } 
public Func<Argument, bool> Verifier { get; } 


public ArgumentDefinition(string argumentSwitch, 
string syntax, 
string description, 
Func<Argument, bool> verifier) 


ArgumentSwitch = argumentSwitch.ToUpper(); 
Syntax = syntax; 

Description = description; 

Verifier = verifier; 


j 


public bool Verify(Argument arg) -» Verifier(arg); 


j 


public sealed class ArgumentSemanticAnalyzer 


{ 


private List<ArgumentDefinition> argumentDefinitions = 
new List<ArgumentDefinition>(); 

private Dictionary<string, Action<Argument>> argumentActions = 
new Dictionary<string, Action<Argument>>(); 
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public ReadOnlyCollection<Argument> UnrecognizedArguments { get; private set; } 
public ReadOnlyCollection<Argument> MalformedArguments { get; private set; } 
public ReadOnlyCollection<Argument> RepeatedArguments { get; private set; } 


public ReadOnlyCollection<ArgumentDefinition> ArgumentDefinitions => 
new ReadOnlyCollection«ArgumentDefinition»(argumentDefinitions); 


public IEnumerable<string> DefinedSwitches => 
from argumentDefinition in argumentDefinitions 
select argumentDefinition.ArgumentSwitch; 


public void AddArgumentVerifier(ArgumentDefinition verifier) => 
argumentDefinitions.Add(verifier); 


public void RemoveArgumentVerifier(ArgumentDefinition verifier) 
{ 
var verifiersToRemove = from v in argumentDefinitions 
where v.ArgumentSwitch == verifier .ArgumentSwitch 
select v; 
foreach (var v in verifiersToRemove) 
argumentDefinitions.Remove(v); 


} 


public void AddArgumentAction(string argumentSwitch, Action<Argument> action) => 
argumentActions.Add(argumentSwitch, action); 


public void RemoveArgumentAction(string argumentSwitch) 


{ 
if (argumentActions.Keys.Contains(argumentSwitch) ) 
argumentActions.Remove(argumentSwitch) ; 


} 


public bool VerifyArguments(IEnumerable<Argument> arguments) 


// 没有 任何 参数 进行 验证 ,失败 


if (!argumentDefinitions.Any()) 
return false; 


// 确认 是 否 存在 任 一 未 定义 的 参数 
this.UnrecognizedArguments = 
( from argument in arguments 
where !DefinedSwitches.Contains(argument. Switch. ToUpper()) 
select argument).ToList().AsReadOnly(); 





if (this.UnrecognizedArguments.Any()) 
return false; 


// 检 查 开 关 与 某 个 已 知 开关 匹配 但 是 检查 格式 是 否 正 确 
// 的 谓词 为 false 的 所 有 参数 
this.MalformedArguments = ( from argument in arguments 
join argumentDefinition in argumentDefinitions 
on argument.Switch.ToUpper() equals 
argumentDefinition.ArgumentSwitch 
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j 


where !argumentDefinition.Verify(argument) 
select argument).ToList().AsReadOnly(); 


if (this.MalformedArguments.Any()) 
return false; 


// 将 所 有 参数 按照 开关 进行 分 组 ,统计 每 个 组 的 数量 ， 
// 并 选 出 包含 超过 一 个 元 素 的 所 有 组 ， 
// 然 后 我 们 获得 一 个 包含 这 些 数据 项 的 只 读 列表 
this.RepeatedArguments = 
(from argumentGroup in 
from argument in arguments 
where !argument.IsSimple 
group argument by argument.Switch.ToUpper() 
where argumentGroup.Count() » 1 
select argumentGroup).SelectMany(ag -» ag).ToList().AsReadOnly(); 














if (this.RepeatedArguments.Any()) 
return false; 


return true; 


public void EvaluateArguments(IEnumerable<Argument> arguments) 


j 


// 此 时 只 需 应 用 每 个 动作 : 
foreach (Argument argument in arguments) 
argumentActions[argument. Switch. ToUpper()](argument) ; 





public string InvalidArgumentsDisplay() 


{ 


StringBuilder builder = new StringBuilder(); 
builder .AppendFormat($"Invalid arguments: {Environment.NewLine}"); 


// 添加 未 识别 的 参数 


FormatInvalidArguments(builder, this.UnrecognizedArguments, 
"Unrecognized argument: {0}{1}"); 


// 添加 格式 不 正式 的 参数 
FormatInvalidArguments(builder, this.MalformedArguments, 
"Malformed argument: {0}{1}"); 





rap 


// 对 于 重复 的 参数 ,我 们 想 要 将 其 分 组 以 用 于 显示 ， 

// 因此 通过 开关 分 组 并 且 将 其 添加 到 正在 构建 的 字符 串 

var argumentGroups = from argument in this.RepeatedArguments 
group argument by argument.Switch.ToUpper() into ag 
select new { Switch = ag.Key, Instances = ag}; 















































foreach (var argumentGroup in argumentGroups) 
{ 
builder .AppendFormat($"Repeated argument: 
{argumentGroup. Switch}{Environment.NewLine}"); 
FormatInvalidArguments(builder, argumentGroup.Instances.ToList(), 


"\t{O}{1}"); 





} 


return builder.ToString(); 


} 


private void FormatInvalidArguments(StringBuilder builder, 
IEnumerable<Argument> invalidArguments, string errorFormat) 


{ 

if (invalidArguments != null) 
foreach (Argument argument in invalidArguments) 
{ 

builder .AppendFormat(errorFormat, 
argument.Original, Environment.NewLine) ; 

} 

} 

} 


} 
如 何 使 用 这 些 类 为 应 用 程序 处 理 命令 行 ? 方法 如 下 所 示 。 


public static void Main(string[] argumentStrings) 


{ 




















var arguments = (from argument in argumentStrings 
select new Argument(argument)).ToArray(); 


Console.Write("Command line: "); 
foreach (Argument a in arguments) 


{ 
} 


Console.WriteLine(""); 


Console.Write($"{a.Original} "); 


ArgumentSemanticAnalyzer analyzer - new ArgumentSemanticAnalyzer(); 
analyzer.AddArgumentVerifier( 
new ArgumentDefinition( "output", 
"/output:[path to output]", 
"Specifies the location of the output file.", 
x => x.IsCompoundSwitch)); 
analyzer .AddArgumentVerifier( 
new ArgumentDefinition("trialMode", 
"[trialmode", 
"If this is specified it places the product into trial mode", 
x => x.IsSimpleSwitch)); 
analyzer.AddArgumentVerifier( 
new ArgumentDefinition("DEBUGOUTPUT", 
"[debugoutput: [value1];[value2];[value3]", 
"A listing of the files the debug output " + 
"information will be written to", 
x => x.IsComplexSwitch)); 
analyzer.AddArgumentVerifier( 
new ArgumentDefinition("", 
"[literal value]", 
"A literal value", 
x => x.IsSimple)); 
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if (!analyzer.VerifyArguments(arguments ) ) 


{ 
string invalidArguments = analyzer.InvalidArgumentsDisplay(); 
Console.WriteLine(invalidArguments); 
ShowUsage(analyzer); 
return; 
} 


// 设置 命令 行 解析 结果 的 容器 

string output = string.Empty; 

bool trialmode = false; 

IEnumerable«string» debugOutput = null; 
List<string> literals = new List<string>(); 


// 我 们 想 对 每 一 个 解析 出 的 参数 应 用 一 个 动作 ， 
// 因 此 将 它们 添加 到 分 析 器 
analyzer.AddArgumentAction("OUTPUT", x => { output = x.SubArguments[0]; }); 
analyzer .AddArgumentAction("TRIALMODE", x => { trialmode = true; }); 
analyzer .AddArgumentAction("DEBUGOUTPUT", x => 

{ debugOutput = x.SubArguments; 








}); 


analyzer .AddArgumentAction("", x=>{literals.Add(x.Original);}); 


// 检查 参数 并 运行 动作 


analyzer.EvaluateArguments(arguments); 


// 显示 结果 

Console.WriteLine(""); 
Console.WriteLine($"OUTPUT: {output}"); 
Console.WriteLine($"TRIALMODE: {trialmode}"); 
if (debugOutput != null) 


{ 
foreach (string item in debugOutput) 
{ 
Console.WriteLine($"DEBUGOUTPUT: {item}"); 
} 
} 
foreach (string literal in literals) 
{ 
Console.WriteLine($"LITERAL: {literal}"); 
} 


} 


public static void ShowUsage(ArgumentSemanticAnalyzer analyzer) 
{ 
Console.WriteLine("Program.exe allows the following arguments:"); 
foreach (ArgumentDefinition definition in analyzer .ArgumentDefinitions) 
{ 
Console.WriteLine($"\t{definition.ArgumentSwitch}: 
({definition.Description}){Environment.NewLine} 
\tSyntax: {definition.Syntax}"); 





1.5.3 ”讨论 

在 解析 命令 行 参数 之 前 ， 必 须 明 确 选用 一 种 通用 格式 。 本 范例 中 使 用 的 格式 遵循 用 于 

Visual C#.NET 语言 编译 器 的 命令 行 格式 。 使 用 的 格式 定义 如 下 所 示 。 

。 通过 一 个 或 多 个 空白 字符 分 隔 命令 行 参数 。 

。 每 个 参数 可 以 以 一 个 - 或 / 字符 开头 ， 但 不 能 同时 以 这 两 个 字符 开头 。 如 果 不 以 其 中 一 
个 字符 开头 ， 就 把 参数 视 为 一 个 字面 量 ， 比 如 文件 名 。 

。 以 -或 /字符 开头 的 参数 可 被 划分 为 : 以 一 个 选项 开关 开头 ， 后 接 一 个 冒号 ， 再 接 一 个 
或 多 个 用 ; 字符 分 隔 的 参数 。 命 令 行 参 数 -sw:arg1;arg2;arg3 可 被 划分 为 一 个 选项 开 
Æ (sw) 和 三 个 参数 (arg1、arg2 和 arg3)。 注 意 ， 在 完整 的 参数 中 不 应 该 有 任何 空格 ， 
否则 运行 时 命令 行 解 析 器 将 把 参数 分 拆 为 两 个 或 更 多 的 参数 。 

© FMS SOREN (an "c:\test\file.log") 会 去 除 双 引号 。 这 是 操作 系统 解释 
传 入 应 用 程序 中 的 参数 时 的 一 项 功能 。 

。 不 会 去 除 单 引号 。 

。 要 保留 双 引 号 ， 可 在 双 引 号 字符 前 放置 \ 转 义 序 列 字 符 。 

。 仅 当 \ 字 符 后 面 接着 双 引 号 时 ， 才 将 \ 字符 作为 转 义 序列 字符 处 理 ， 在 这 种 情况 下 ， 只 
会 显示 双 引 号 。 

。 ^ 字 符 被 运行 时 解析 器 作为 特殊 字符 处 理 。 

幸运 的 是 ， 在 应 用 程序 接收 各 个 解析 出 的 参数 之 前 ， 运 行 时 命令 行 解 析 器 可 以 处 理 其 中 大 

部 分 任务 。 

运行 时 命令 行 解 析 器 把 一 个 包含 每 个 解析 过 的 参数 的 string[] 传递 给 应 用 程序 的 入 口 点 。 

入 口 点 可 以 采用 以 下 形式 之 一 。 


public static void Main() 
public static int Main() 
public static void Main(string[] args) 
public static int Main(string[] args) 


前 两 种 形式 不 接受 参数 ， 但 是 后 两 种 形式 接受 解析 过 的 命令 行 参数 的 数组 。 广 意 ， 静 态 
属性 Environment commandline 将 返回 一 个 字符 串 ， 其 中 包含 完整 的 命 信行， 静态 方 法 
Environment.GetCommandLineArgs 将 返回 一 个 字符 串 数 组 ， 其 中 包含 解析 过 的 命令 行 参 数 。 
1.5.2 市 介绍 的 三 个 类 涉及 命令 行 参 数 的 各 个 阶段 。 
e Argument 

封装 一 个 命令 行 参 数 并 负责 解析 该 参数 。 
e ArgumentDefinition 

定义 一 个 对 当 行 命令 行 有 效 的 参数 。 
e ArgumentSemanticAnalyzer 
基于 设置 的 ArgumentDefinition 进行 参数 的 验证 和 获取 。 
把 以 下 命令 行 参数 传 入 这 个 应 用 程序 中 : 
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MyApp c:\input\infile.txt -output:d:\outfile.txt -trialmode 


将 得 到 以 下 解析 过 的 选项 开关 和 参数 。 


Command line: c:\input\infile.txt -output:d:\outfile.txt -trialmode 
OUTPUT: d:\outfile.txt 

TRIALMODE: True 

LITERAL: c:\input\infile. txt 


如 果 你 没有 正确 地 输入 命令 行 参数 ， 比 如 忘记 了 向 -output 选项 开关 添加 参数 ， 得 到 的 输 
出 将 如 下 所 示 。 
Command line: c:\input\infile.txt -output: -trialmode 


Invalid arguments: 
Malformed argument: -output 




















Program.exe allows the following arguments: 
OUTPUT: (Specifies the location of the output file.) 
Syntax: /output:[path to output] 
TRIALMODE: (If this is specified, it places the product into trial mode) 
Syntax: /trialmode 
DEBUGOUTPUT: (A listing of the files the debug output information will be 
written to) 
Syntax: /debugoutput: [value1]; [value2]; [value3] 
: (A literal value) 
Syntax: [literal value] 


在 这 段 代 码 中 有 几 个 值得 指出 的 地 方 。 


每 个 Argument 实例 都 需要 能 确定 它 自身 的 某 些 事项 。 相 应 地 ， 作 为 Argument 的 属性 暴露 
了 一 组 谓词 ， 告 诉 我 们 这 个 Argument 的 一 些 有 用 信息 。ArgumentSemanticAnalyzer 将 使 用 
这 些 属 性 来 确定 参数 的 特征 。 


public bool IsSimple => SubArguments.Count == 0; 
public bool IsSimpleSwitch => 

!string.IsNullOrEmpty(Switch) && SubArguments.Count == 0; 
public bool IsCompoundSwitch => 

!Istring.IsNullOrEmpty(Switch) && SubArguments.Count == 1; 
public bool IsComplexSwitch => 

!Istring.IsNullOrEmpty(Switch) && SubArguments.Count > 0; 








关于 lambda 表达 式 的 更 多 信息 请 参考 4.0 节 。 范 例 1.16 (BN 1.16 35). 中 也 
包含 了 使 用 lambda 表达 式 来 实现 闭 包 的 相关 讨论 。 

















这 段 代 码 有 多 处 在 LINQ 查询 的 结果 上 调用 了 ToArray 或 ToList 方法 。 


var arguments = (from argument in argumentStrings 
select new Argument(argument)).ToArray(); 


这 是 由 于 查询 结果 是 延迟 执行 的 。 这 不 仅 意 味 着 将 以 迟缓 方式 来 计算 结果 ， 而 且 意 味 着 每 











次 访问 结果 时 都 要 重新 计算 它们 。 使 用 ToArray 或 ToList 方法 会 强制 积极 计算 结果 ， 生 成 
一 份 不 需要 在 每 次 使 用 时 都 重新 计算 的 副本 。 查 询 逻 辑 并 不 知道 正在 操作 的 集合 是 否 发 生 























了 变化 ， 因 此 每 次 都 必须 重新 计算 结果 ， 除 非 使 用 这 些 方法 创建 出 一 份 “即时 ”副本 。 


为 了 验证 这 些 参 数 是 否 正确 ， 必 须 创 建 ArgumentDefinition， 并 将 每 个 可 接受 的 参数 类 型 








与 ArgumentSemanticAnalyzer 相关 联 ， 代 码 如 下 所 示 。 


ArgumentSemanticAnalyzer analyzer = new ArgumentSemanticAnalyzer(); 
analyzer .AddArgumentVerifier( 
new ArgumentDefinition( "output", 
"/output:[path to output]", 
"Specifies the location of the output file.", 
x => x.IsCompoundSwitch)); 
analyzer .AddArgumentVerifier( 
new ArgumentDefinition("trialMode", 
"[trialmode", 
"If this is specified it places the product into trial mode", 
x => x.IsSimpleSwitch)); 
analyzer.AddArgumentVerifier( 
new ArgumentDefinition("DEBUGOUTPUT", 
"/debugoutput: [value1]; [value2]; [value3]", 
"A listing of the files the debug output " 4 
"information will be written to", 
x => x.IsComplexSwitch)); 
analyzer.AddArgumentVerifier( 
new ArgumentDefinition("", 
"[literal value]", 
"A literal value", 
x => x.IsSimple)); 


每 个 ArgunentDefinition 都 包含 4 个 部 分 : 参数 选项 开关 、 显 示 参 数 语 法 的 字符 串 、 参 数 








说 明 以 及 用 于 验证 参数 的 验证 谓词 。 这 些 信息 可 以 用 于 验证 参数 ， 如 下 所 示 。 


// 检 查 开关 与 某 个 已 知 开关 匹配 但 是 检查 格式 是 否 正确 

// 的 谓词 为 false 的 所 有 参数 

this.MalformedArguments = ( from argument in arguments 

join argumentDefinition in argumentDefinitions 
on argument.Switch.ToUpper() equals 
argumentDefinition.ArgumentSwitch 

where !argumentDefinition.Verify(argument) 
select argument).ToList().AsReadOnly(); 


ArgumentDef inition 还 允许 为 程序 编写 一 个 使 用 说 明 方 法 。 


public static void ShowUsage(ArgumentSemanticAnalyzer analyzer) 








{ 
Console.WriteLine("Program.exe allows the following arguments:"); 
foreach (ArgumentDefinition definition in analyzer.ArgumentDefinitions) 
{ 

Console.WriteLine("\t{0}: ({1}){2}\tSyntax: {3}", 
definition.ArgumentSwitch, definition.Description, 
Environment.NewLine, definition. Syntax) ; 

} 
} 
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为 了 获取 参数 的 值 以 便 使 用 它们 ， 需 要 从 解析 过 的 参数 中 提取 信息 。 对 于 解决 方案 示例 ， 
我 们 需要 以 下 信息 。 
// 设置 命令 行 解析 结果 的 容器 
string output = string.Empty; 
bool trialmode = false; 


IEnumerable<string> debugOutput = null; 
List<string> literals = new List<string>(); 


如 何 填充 这 些 值 ? 对 于 每 个 参数 ， 都 需要 一 个 与 之 关联 的 动作 ， 以 确定 如 何 从 Argument 实 


例 获 得 值 。 每 个 动作 就 是 一 个 谓词 ， 这 使 得 这 种 方式 非常 强大 ， 因 为 你 在 这 里 可 以 使 用 任 




















何谓 词 。 下 面 的 代码 说 明 如 何 定义 这 些 argument 动作 并 将 其 与 ArgunentsemanticAnatyzer 











相关 联 。 

















// 对 于 每 一 个 解析 出 的 参数 ,我 们 想 要 对 其 应 用 一 个 动作 ， 
// 因 此 将 它们 添加 到 分 析 器 
analyzer .AddArgumentAction( "OUTPUT", x => { output = x.SubArguments[0]; }); 
analyzer .AddArgumentAction("TRIALMODE", x => { trialmode = true; }); 
analyzer .AddArgumentAction("DEBUGOUTPUT", x => 














{ debugOutput = x.SubArguments;}); 


analyzer .AddArgumentAction("", x=>{literals.Add(x.Original);}); 





现在 已 经 建立 了 所 有 的 动作 ， 就 可 以 对 ArgumentSemanticAnalyzer 应 用 EvaluateArguments 

方法 来 获取 值 ， 代 码 如 下 所 示 。 
// 检查 参数 并 运行 动作 
analyzer .EvaluateArguments(arguments); 

现在 通过 执行 动作 填充 了 值 ， 并 且 可 以 利用 这 些 值 来 运行 程序 ， 代 码 如 下 所 示 。 
// 传 入 参数 值 并 运行 程序 


Program program = new Program(output, trialmode, debugOutput, literals); 
program.Run(); 


























如 果 在 验证 参数 时 使 用 LINQ 来 查询 未 识别 的 、 格 式 错误 的 或 者 重复 的 实 参 (argument)， 
其 中 任何 一 项 都 会 导致 形 参 (parameter) 无 效 。 


public bool VerifyArguments(IEnumerable<Argument> arguments) 


{ 


// 没有 任何 参数 进行 验证 ,失败 
if (!argumentDefinitions.Any()) 
return false; 














// 确认 是 否 存在 任 一 未 定义 的 参数 


this.UnrecognizedArguments = 

( from argument in arguments 
where !DefinedSwitches.Contains(argument.Switch.ToUpper()) 
select argument).ToList().AsReadOnly(); 


if (this.UnrecognizedArguments Any () ) 
return false; 


IHREN 


F 关 与 某 个 已 知 开 关 





匹配 但 是 检查 格式 是 否 正确 





// 的 谓词 为 false 的 所 有 参数 
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} 


this.MalformedArguments = ( from argument in arguments 
join argumentDefinition in argumentDefinitions 
on argument.Switch.ToUpper() equals 

argumentDefinition.ArgumentSwitch 

where !argumentDefinition.Verify(argument) 
select argument).ToList().AsReadOnly(); 

if (this.MalformedArguments.Any()) 

return false; 











// 将 所 有 参数 按照 开关 进行 分 组 ,统计 每 个 组 的 数量 ， 
// 并 选 出 包含 超过 一 个 元 素 的 所 有 组 ， 
// 然 后 我 们 获得 一 个 包含 这 些 数据 项 的 只 读 列 表 
this.RepeatedArguments = 
(from argumentGroup in 
from argument in arguments 
where !argument.IsSimple 
group argument by argument. Switch. ToUpper() 
where argumentGroup.Count() > 1 
select argumentGroup).SelectMany(ag => ag).ToList().AsReadOnly(); 











if (this.RepeatedArguments.Any()) 
return false; 


return true; 

















5 LINQ HEL niji xt A KAVA, switch 语句 、Indexof 方法 及 其 他 机 制 实现 同样 功 


能 的 代码 
领域 的 语 





1.5.4 


MSDN 文档 中 的 “Main” 和 “ 命 4 


1.6 


1.6.1 











相 比 ， 上 述 使 用 LINQ 的 代码 更 加 易于 理解 每 一 个 验证 阶段 。 每 个 查询 都 用 问题 
言 简洁 地 指出 了 它 在 尝试 执行 什么 任务 。 

















LINQ 旨 在 帮助 解决 那些 必须 排序 、 查 找 、 分 组 、 算 选 和 投影 数据 的 问题 。 
请 使 用 它 ! 


参考 


Md 
y 
z 
z 
a 





在 运行 时 初始 化 常量 字段 


问题 





标记 为 const 的 字段 只 能 在 编译 时 初始 化 。 你 需要 在 运行 时 而 不 是 在 编译 时 将 一 个 字段 初 
始 化 为 一 个 有 效 值 。 然 后 在 应 用 程序 剩余 的 生命 期 内 ， 这 个 字段 必须 像 一 个 常量 字段 那样 


工作 。 
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1.6.2 ”解决 方案 


在 代码 中 声明 一 个 常量 值 时 有 两 种 选择 。 你 可 以 使 用 readonly 字段 或 const 字段 ， 每 种 方 
式 都 有 其 优 缺 点 。 不 过 ， 如 果 你 需要 在 运行 时 初始 化 一 个 常量 字段 ， 就 必须 使 用 readonly 
字段 。 




















public class Foo 


{ 


public readonly int bar; 
public Foo() {} 

public Foo(int constInitValue) 
i bar = constInitValue; 


} 
// 类 的 其 他 部 分 





} 
使 用 const 字段 无 法 做 到 这 一 点 。const 字段 只 能 在 编译 时 初始 化 。 





public class Foo 





: public const int bar; // 这 一 行 造成 一 个 编译 时 错误 
public Foo() {} 
public Foo(int constInitValue) 
: bar = constInitValue; // 这 一 行 同 样 造成 一 个 编译 时 错误 
à H 类 的 其 他 部 分 


1.6.3 讨论 

readonly 字段 只 允许 在 运行 时 在 构造 函数 中 执行 初始 化 ， 而 const 字段 必须 在 编译 时 进行 
初始 化 。 因 此 ， 为 了 让 一 个 必须 为 常量 的 字段 在 运行 时 初始 化 ， 唯 一 的 方式 是 实现 一 个 
readonly 字段 。 

只 有 两 种 方式 可 用 于 初始 化 一 个 readonly 字段 。 第 一 种 方式 是 向 字段 自身 添加 一 个 初始 化 
av, FRSA PHI. 

public readonly int bar = 100; 

第 二 种 方式 是 通过 一 个 构造 函数 初始 化 readonly 字段 。1.6.2 节 中 的 代码 演示 了 这 种 方法 。 
如 果 查 看 下 面 的 类 : 


public class Foo 


{ 




















public readonly int x; 
public const int y = 1; 
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public Foo() {} 

public Foo(int roInitValue) 
{ 

} 


// 类 的 其 他 部 分 


x = roInitValue; 














} 
你 会 看 到 它 被 编译 成 下 面 的 中 间 语 言 (intermediate language, IL) : 


.CLass auto ansi nested public beforefieldinit Foo 
extends [mscorlib]System.Object x 


.field public static literal int32 y = int32(0x00000001) //««-- const field 
.field public initonly int32 x //<<-- readonly field 


.method public hidebysig specialname rtspecialname 
instance void .ctor(int32 roInitValue) cil managed 
{ 
// Code size 16 (0x10) 
.maxstack 8 
IL 0000: ldarg.0 


IL 0001: call instance void [mscorlib]System.Object::.ctor() 
IL 0006: nop 
IL 0007: nop 


IL 0008: ldarg.0 
IL 0009: ldarg.1 


IL 000a: stfld int32 CSharpRecipes.ClassesAndGenerics/Foo::x 
IL 000f: ret 
) // end of method Foo::.ctor 
.nethod public hidebysig specialname rtspecialname 
instance void .ctor() cil managed 
{ 
// Code size 9 (0x9) 
-maxstack 8 
IL 0000: ldarg.0 
IL 0001: call instance void [mscorlib]System.Object::.ctor() 
IL 0006: nop 
IL 0007: nop 


IL 0008: ret 
} // end of method Foo::.ctor 
) // End of class Foo 


注意 const 字段 被 编译 成 一 个 静态 字段 ，readonly 字段 被 编译 成 一 个 实例 字段 。 因 此 ， 只 





需要 类 名 就 可 以 访问 一 个 const 字段 。 























对 于 使 用 const 字段 的 一 个 常见 争论 是 ， 它 们 并 不 像 readonly 字段 那样 支 
持 版 本 化 。 如 果 重 新 构建 一 个 定义 了 const 字段 的 组 件 ， 并 且 


该 const 字段 








的 值 在 之 后 的 版 本 中 发 生 了 改变 ， 那 么 使 用 旧版 本 构建 的 任何 











const 字段 。 


下 面 的 代码 显示 了 如 何 使 用 一 个 readonly 实例 字段 。 





其 他 组 件 都 不 


会 获得 新 的 值 。 只 要 一 个 字段 将 来 有 可 能 发 生 改变 ， 就 不 要 把 它 声明 为 一 个 
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Foo obj1 = new Foo(100); 
Console.WriteLine(obj1.bar); 


16.4 ”参考 
MSDN 文档 中 的 “const” 和 “readonLy” 关 键 字 。 


1.7 构建 可 克隆 的 类 


1.7.1 问题 


你 需要 一 种 方法 对 可 能 引用 其 他 类 型 的 数据 类 型 进行 浅 克隆 操作 、 深 克隆 操作 或 者 同时 
执行 这 两 种 操作 ， 但 是 不 应 该 使 用 ICloneable 接口 ， 因 为 它 违反 了 .NET Framework 设 
计 准 则 。 


1.7.2 ”解决 方案 


为 了 解决 使 用 ICloneable 的 问题 ， 创 建 另 外 两 个 接口 IShallowCopy«T» 和 IDeepCopy<T> 来 
建立 一 种 复制 模式 ， 代 码 如 下 所 示 。 


public interface IShallowCopy<T> 


























T ShallowCopy(); 


} 
public interface IDeepCopy<T> 


T DeepCopy(); 
} 


浅 复 制 意味 着 所 复制 对 象 的 字段 将 引用 与 原始 对 象 相同 的 对 象 。 为 了 允许 进 
在 类 中 实现 IShallowCopy<T> 接口 ， 代 码 如 下 所 示 。 
using System; 


using System.Collections; 
using System.Collections.Generic; 


l 


浅 复 制 ， 可 


bal 








public class ShallowClone : IShallowCopy<ShallowClone> 


{ 

public int Data = 1; 

public List<string> ListData = new List<string>(); 

public object ObjData = new object(); 

public ShallowClone ShallowCopy() => (ShallowClone)this.MemberwiseClone(); 
} 


深 复制 〈 或 称 克 隆 ) 意味 着 所 复制 对 象 的 字段 将 引用 原始 对 象 的 字段 的 新 副本 。 为 了 进行 
深 复制 ， 可 在 类 中 实现 IDeepCopy<T> 接口 ， 代 码 如 下 所 示 。 


using System; 
using System.Collections; 
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using System.Collections.Generic; 
using System.Runtime.Serialization.Formatters.Binary; 
using System.IO; 


[Serializable] 
public class DeepClone : IDeepCopy<DeepClone> 
{ 


public int data = 1; 
public List<string> ListData = new List<string>(); 
public object objData = new object(); 


public DeepClone DeepCopy( ) 


{ 
BinaryFormatter BF = new BinaryFormatter(); 
MemoryStream memStream = new MemoryStream(); 
BF.Serialize(memStream, this); 
memStream.Flush(); 
memStream.Position - 0; 
return (DeepClone)BF.Deserialize(memStream); 
} 


} 


Be [R]IT Sc PEOR HAR HUTT, TTR SEP, ACSA PHI. 





using System; 

using System.Collections; 

using System.Collections.Generic; 

using System.Runtime.Serialization.Formatters.Binary; 
using System.IO; 


[Serializable] 

public class MultiClone : IShallowCopy«MultiClone», 
IDeepCopy<MuLtiClone> 

{ 


public int data = 1; 
public List<string> ListData = new List<string>(); 
public object objData = new object(); 


public MultiClone ShallowCopy() => (MultiClone)this.MemberwiseClone(); 


public MultiClone DeepCopy() 
{ 


BinaryFormatter BF = new BinaryFormatter(); 
MemoryStream memStream = new MemoryStream(); 


BF.Serialize(memStream, this); 
memStream.Flush(); 


memStream.Position - 0; 


return (MultiClone)BF.Deserialize(memStream); 
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1.7.3 讨论 

NET Framework 中 包含 一 个 名 为 ICloneable 的 接口 ， 它 最 初 被 设计 为 在 NET 中 实现 克隆 
的 方法 。 设 计 建 议 现在 不 再 在 任何 公开 API 中 使 用 这 个 接口 ， 因 为 它 容 易 将 自身 导向 不 同 
的 解释 。 此 接口 看 起 来 如 下 所 示 。 


public interface ICloneable 


{ 
object Clone(); 


} 
注意 此 接口 只 有 一 个 方法 Clone， 它 返回 一 个 对 象 。 该 克隆 是 对 象 的 浅 副 本 还 是 深 副本 
呢 ? 无 法 通过 该 接口 得 知 这 一 点 ， 因 为 实现 可 以 选择 任何 一 个 方式 。 这 就 是 不 应 该 再 使 用 
它 ， 而 是 引入 IShaLLowCopy<T> 和 IDeepCopy<T> 接口 的 原因 。 
克隆 操作 能 够 创建 出 类 型 实例 的 一 个 准确 副本 (克隆 )。 克 隆 可 能 采用 两 种 形式 之 一 : iX 
复制 和 深 复 制 。 浅 复制 相对 容易 一 些 ， 它 对 涉及 复制 的 对 象 调 用 ShaLLowCopy 方法 。 
在 原始 对 象 中 ， 引 用 类 型 的 字段 像 值 类 型 的 字段 那样 进行 复制 。 例 如 ， 如 果 原 始 对 象 包含 
一 个 StreamWriter 类 型 的 字段 ， 克 隆 的 对 象 将 指向 原始 对 象 的 StreamWriter 的 同一 个 实 
例 ， 并 没有 创建 新 对 象 。 
在 执行 克隆 操作 时 无 需 处 理 静 态 字段 。 每 个 应 用 程序 域 中 的 每 个 类 的 每 个 
静态 字段 只 会 保留 一 个 内 存 位置 。 克 隆 出 的 对 象 与 原始 对 象 访问 相同 的 静 


SFE. 















































对 浅 复 制 的 支持 是 通过 Object 类 的 MenberwiseClone 方法 来 实现 的 ，object 类 充当 了 所 
有 .NET 类 的 基 类 。 因 此 ， 下 面 的 代码 通过 Clone 方法 允许 创建 和 返回 一 个 浅 复制 。 


public ShallowClone ShallowCopy() => (ShallowClone)this.MemberwiseClone(); 


克隆 一 个 对 象 的 另 一 种 方式 是 创建 深 复制 。 就 像 浅 复 制 那样 ， 深 复制 将 创建 原始 对 象 的 一 
个 副本 。 不 同 的 是 ， 深 复制 还 会 创建 原始 对 象 中 每 个 引用 类 型 的 字段 的 单独 副本 。 因 此 ， 
如 果 原 始 对 象 包含 一 个 StreamWriter 类 型 的 字段 ， 复 制 的 对 象 也 会 包含 一 个 StreamWriter 
类 型 的 字段 ， 但 是 复制 对 象 的 StreamWriter 字段 将 指向 一 个 新 的 StreamWriter 对 象 ， 而 不 
是 原始 对 象 的 StreamWriter 对 象 。 
NET Framework 没有 直接 提供 对 次 复制 的 支持 ， 但 是 下 面 的 代码 提供 了 一 种 实现 次 复制 的 
简单 方式 。 

BinaryFormatter BF = new BinaryFormatter(); 

MemoryStream memStream = new MemoryStream(); 

















BF.Serialize(memStream, this); 
memStream.Flush(); 
memStream.Position - 0; 


return (BF.Deserialize(memStream)); 














总 而 言 之 ， 这 使 用 二 进 制 序列 化 将 原始 对 象 序列 化 到 一 个 内 存 流 中 ， 然 后 将 其 反 序列 化 到 
一 个 新 对 象 中 ， 并 将 该 对 象 返 回 给 调用 者 。 在 调用 Deserialize 方法 之 前 将 内 存 流 指针 重 
新 定位 到 流 的 开始 处 是 十 分 重要 的 ， 否 则 就 会 引发 一 个 异常 ， 指 示 序列 化 的 对 象 中 不 包含 
任何 数据 。 

使 用 对 象 序列 化 执行 深 复制 时 ， 不 必修 改 执行 深 复制 的 代码 就 能 改 下 层 的 对 象 。 如 果 你 

动 执 行 深 复制 ， 就 必须 对 原始 对 和 象 的 每 个 实例 字段 创建 新 实例 ， 并 把 新 实例 复制 到 克隆 的 
对 象 。 这 是 一 件 非 常 琐碎 的 事情 。 如 果 修 改 了 原始 对 象 的 字段 ， 你 必须 修改 深 复制 的 代码 
以 反映 出 这 些 修改 。 使 用 序列 化 可 以 依靠 序列 化 器 动态 查找 和 序列 化 对 象 中 包含 的 所 有 字 
段 。 如 果 修 改 了 对 象 ， 序 列 化 器 仍然 不 需要 修改 就 可 以 进行 深 复制 。 


你 可 能 想 手动 执行 深 复 制 的 一 个 原因 是 ， 仅 当 对 象 中 的 一 切 都 可 序列 化 时 ， 本 范例 中 介绍 
的 序列 化 技术 才 会 正确 工作 。 当 然 ， 手 动 复制 有 时 也 于 事 无 欠 ， 因 为 有 些 对 象 天 生 就 是 不 
可 复制 的 。 假 设 你 有 一 个 网 络 管理 应 用 ， 甚 中 一 个 对 象 代表 网 络 上 的 一 台 特 定 打印 机 。 当 
你 复制 它 时 会 指望 它 做 什么 呢 ? 传 真一 份 订购 单 以 购买 一 台新 的 打印 机 吗 ? 


深 复制 与 生 供 来 的 一 个 问题 是 在 具有 循环 引用 的 嵌 套 数据 结构 上 执行 深 复制 。 本 范例 使 得 
处 理 循 环 引用 成 为 可 能 ， 尽 管 这 仍 是 一 个 难题 。 因 此 ， 事 实 上 ， 如 果 你 使 用 本 范例 中 的 方 
法 ， 就 无 需 避 免 循 环 引 用 。 

1.7.4 参考 


Krzysztof Cwalina 和 Brad Abrams 所 著 的 《.NET 设计 规范 : 约定 、 惯 用 法 与 模式 (第 2 
版 )》; MSDN 文档 中 的 “0bject.MemberwiseClone 方法 ”主题 。 


1.8 ”确保 对 象 的 处 置 


1.8.1 问题 
当 一 个 对 象 的 工作 完成 或 者 超出 作用 域 时 ， 你 需要 采用 一 种 方式 确保 一 些 处 理 得 到 执行 。 


1.8.2 ”解决 方案 
使 用 using 语句 ， 代 码 如 下 所 示 。 


using System; 
using System.IO; 



























































ee 


using(FileStream FS = new FileStream("Test.txt", FileMode.Create) ) 
{ 

FS.WriteByte((byte)1); 

FS.WriteByte((byte)2); 

FS.WriteByte((byte)3); 


using(StreamWriter SW - new StreamWriter(FS)) 
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SW.WriteLine("some text."); 


1.8.3 讨论 
using 语句 非常 易于 使 用 ， 并 且 可 以 避免 编写 多 余 代 码 的 麻烦 。 如 果 解 决 方案 中 没有 使 用 
using 语句 ， 将 会 如 下 所 示 。 


FileStream FS = new FileStream("Test.txt", FileMode.Create); 
try 
{ 

FS.WriteByte((byte)1); 

FS.WriteByte((byte)2); 

FS.WriteByte((byte)3); 








StreamWriter SW = new StreamWriter(FS); 
try 


SW.Writeline("some text."); 


} 
finally 
{ 
if (SW != null) 
{ 
((IDisposable)SW).Dispose(); 
} 
} 
finally 


if (FS != null) 


((IDisposable)FS).Dispose(); 
} 
} 


关于 using 语句 ， 需 要 注意 以 下 几 点 。 


。 存在 一 个 using 指令 ， 如 下 所 示 。 应 将 其 与 using 语句 区 分 开 。 这 可 能 会 使 初次 接触 这 
一 语言 的 开发 人 员 混 消 。 


using System.IO; 


。 using 语句 的 子 句 中 定义 的 变量 都 必须 具有 相同 的 类 型 ， 并 且 必 须 具有 一 个 初始 化 器 
不 过 ， 因 为 可 以 在 单个 代码 块 前 使 用 多 个 using 语句 ， 所 以 这 并 不 是 一 个 重大 的 限制 。 

e using 子 句 中 定义 的 变量 在 using 语句 体 中 被 认为 是 只 读 的。 这 可 以 阻止 开发 人 员 在 党 
试 处 置 变量 最 初 引 用 的 对 象 时 无 意 中 将 变量 转变 成 引用 不 同 的 对 象 ， 避 免 引 发 问题 。 

。 不 应 该 在 using 块 外 声明 变量 ， 然 后 在 using 子 句 内 初始 化 它 。 
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下 面 的 代码 说 明了 最 后 一 点 。 


FileStream FS; 
using(FS = new FileStream("Test.txt", FileMode.Create) ) 











FS.WriteByte((byte)1); 
FS.WriteByte((byte)2); 
FS.WriteByte((byte)3); 


using(StreamWriter SW - new StreamWriter(FS)) 


{ 
} 


SW.WriteLine("some text."); 


} 
对 于 这 段 示 例 代 码 来 说 ， 不 会 有 任何 问题 。 但 是 ， 要 考虑 到 变量 FS 是 可 以 在 using 块 外 使 
用 的 。 实 际 上 ， 可 以 将 这 段 代 码 修改 为 下 面 这 样 。 


FileStream FS; 
using(FS = new FileStream("Test.txt", FileMode.Create) ) 























{ 
FS.WriteByte((byte)1); 
FS.WriteByte((byte)2); 
FS.WriteByte((byte)3); 
using(StreamWriter SW - new StreamWriter(FS)) 
SW.Writeline("some text."); 
} 
} 


FS.WriteByte((byte)4); 


这 段 代 码 可 以 编译 ， 但 会 在 这 个 代码 段 的 最 后 一 行 上 引发 一 个 ObjectDisposedException, 
因为 已 经 对 FS 对 象 调用 了 Dispose 方法 。 对 象 此 时 还 没有 被 垃圾 回收 ， 仍 然 以 被 处 置 过 的 
状态 存在 于 内 存 中 。 


18.4 ”参考 


MSDN 文档 中 的 “Cleaning Up Unmanaged Resources”“IDisposable 接口 ”“Using foreach 
with Collections” 和 “实现 Finalize 和 Dispose 以 清理 非 托管 资源 ”主题 。 


1.9 ”确定 何 时 何 处 使 用 泛 型 


1.9.1 问题 
你 想 在 新 项 目 中 使 用 泛 型 类 型 或 者 把 现 有 项 目 中 的 非 泛 型 类 型 转换 成 它们 对 应 的 泛 型 类 
型 。 不 过 ， 你 并 不 真正 明白 为 什么 要 这 样 做 ， 也 不 知道 应 该 把 哪些 非 泛 型 类 型 转换 成 泛 型 
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1.9.2 ”解决 方案 
在 决定 何 时 何 处 使 用 泛 型 类 型 时 ， 需 要 考虑 以 下 几 点 。 


。 你 的 类 型 将 包含 或 操作 多 种 不 同 的 未 确定 数据 类 型 〈 例 如 , 一 种 集合 类 型 ) 吗 ? 如 果 是 ， 
那么 与 创建 非 泛 型 类 型 相 比 ， 创 建 泛 型 类 型 会 有 儿 个 好 处 。 如 果 你 的 类 型 只 操作 某 种 特 
定 的 类 型 ， 那 么 可 能 不 需要 创建 泛 型 类 型 。 

。 如 果 你 的 类 型 在 值 类 型 上 操作 ， 那 么 将 会 发 生 装 箱 和 拆 箱 操作 。 你 应 该 考虑 使 用 泛 型 来 
避免 装 箱 和 拆 箱 操作 带 来 的 性 能 损失 。 

。 与 泛 型 关联 的 更 强大 的 类 型 检查 有 助 于 更 快 地 ( 即 在 编译 时 而 不 是 在 运行 时 ) 找 出 错误 ， 
从 而 缩短 错误 修正 周期 。 

。 由 于 你 编写 了 多 个 类 来 处 理 不 同 的 数据 类 型 (例如 ,使 用 一 个 专门 的 ArrayList 只 存储 
StreamReader , 并 使 用 另 一 个 ArrayList 只 存储 StreamWriter), 这 导致 你 的 代码 产生 “ 代 
II” TE? 更 容易 的 做 法 是 ， 编 写 一 次 代码 ， 使 其 适用 于 所 操作 的 所 有 数据 类 型 。 

e 泛 型 可 以 使 得 代码 更 清晰 。 通 过 消除 代码 膨胀 并 强制 对 类 型 执行 更 强大 的 类 型 检查 ， 可 
以 使 代码 更 易于 阅读 和 理解 。 

































































1.9.3 讨论 

在 大 多 数 情况 下 ， 你 的 代码 将 受益 于 使 用 泛 型 类 型 。 泛 型 可 以 实现 更 高 效 的 代码 重用 ， 更 
快速 的 性 能 ， 更 强大 的 类 型 检查 和 更 易于 阅读 的 代码 。 

1.9.4 ”参考 

MSDN 文档 中 的 “ 泛 型 概述 ”和 “ 泛 型 的 优点 ”主题 。 


1.10 理解 泛 型 类 型 


1.10.1 问题 


你 需要 理解 .NET 类 型 如 何 适 用 于 泛 型 ， 以 及 泛 型 NET 类 型 与 常规 NET 类 型 有 着 怎样 的 
区 别 。 


1.10.2 解决 方案 

可 以 用 两 个 快速 的 试验 来 展示 常规 NET 类 型 和 泛 型 NET 类 型 之 间 的 区 别 。 在 深入 代码 之 
前 ， 如 果 你 对 泛 型 不 熟悉 ， 可 以 先 跳 到 具体 解释 泛 型 的 1.10.3 市 ， 之 后 再 回 到 本 部 分 。 

当 定义 一 个 常规 NET 类 型 时 ， 它 看 起 来 就 像 是 例 1-6 中 定义 的 FixedSizeCollection 类 型 。 


例 1-6: FixedSizeCollection (一 种 常规 .NET 类 型 ) 
public class FixedSizeCollection 


{ 








/// <summary> 


/// 构造 函数 ,增加 静态 计数 器 的 值 
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/// 设置 数据 项 最 大 数量 
/// </summary> 
/// <param name="maxItems"></param> 
public FixedSizeCollection(int maxItems) 
{ 
FixedSizeCoLllection. InstanceCount++; 
this.Items = new object[maxItems]; 
} 
/// <summary> 
/// 将 一 个 未 知 类 型 的 数据 项 添加 到 类 
/// object 可 以 包含 任何 类 型 
/// </summary> 
/// «param name="item"> 要 添加 的 数据 项 </param> 
/// <returns> 新 添加 的 数据 项 的 索引 </returns> 
public int AddItem(object item) 





u 








{ 
if (this.ItemCount < this.Items.Length) 
{ 
this.Items[this.ItemCount] = item; 
return this.ItemCount++; 
} 
else 
throw new Exception("Item queue is full"); 
} 


/// <summary> 

/// WAR EA BEL 

/// </summary> 

/// <param name="index"> 要 获取 的 数据 项 的 索引 </param> 
/// <returns>object 类 型 的 一 个 数据 项 </returns> 

public object GetItem(int index) 


{ 
if (index >= this.Items.Length && 
index >= 0) 
throw new ArgumentOutOfRangeException(nameof(index)); 
return this.Items[index]; 
} 


#region Properties 

/// <summary> 

/// 静态 的 实例 计数 器 ,用 于 标准 类 型 

/// </summary> 

public static int InstanceCount { get; set; } 




















/// <summary> 

/// 类 中 包含 的 数据 项 数量 

/// </summary> 

public int ItemCount { get; private set; } 





/// <summary> 

/// 类 中 包含 的 数据 项 

/// </summary> 

private object[] Items { get; set; } 
#endregion // Properties 
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j 


/// <summary> 

/// 重 写 ToSstring 以 提供 类 的 详细 信息 

/// </summary> 

/// <returns> 包 含 类 详细 信息 .格式 化 过 的 字符 串 </returns> 


public override string ToString() => 


S"There are {FixedSizeCollection. InstanceCount.ToString()} 
instances of {this.GetType().ToString()} and this instance 


contains {this.ItemCount} items..."; 


FixedSizeCollection 拥有 一 个 静态 整 型 属性 变量 InstanceCount， 在 实例 构造 函数 中 递增 ， 
还 包含 一 个 ToString() 赫 代 ， 用 于 输出 这 个 AppDomain.FixedSizeCollection 中 存在 多 少 
个 FixedSizeCollection 的 实例 。 此 外 ， 此 集合 类 还 包含 一 个 objects(Items) 的 数组 ， 其 
大 小 由 传人 构造 函数 的 项 数量 确定 。FixedsizeCollection 还 实现 了 两 个 方法 (AddItem 和 
GetItem)， 用 于 添加 和 获取 数据 项 ， 实 现 了 一 个 只 读 属性 (ItemCount)， 用 于 获取 数组 中 
当前 的 数据 项 数量 。 


FixedSizeCollection<T> 类 型 是 一 种 泛 型 .NET 类型， 
InstanceCount、 统 计 实 例 化 次 数 的 实例 构造 函数 ， 以 及 重 写 的 ToStringO Hik, MTH 








它 上 共有 相同 的 静态 属性 字段 


LI 





O 


这 种 类 型 的 实例 有 多 少 个 。FixedsizeCollection<T> 还 具有 一 个 Items 数组 属性 ， 以 及 与 
FixedSizeCollection 类 对 应 的 方法 ， 如 例 1-7 所 示 。 


例 1-7: FixedSizeCollection<T> (一 种 泛 型 NET 类 型 ) 

/// <summary> 

/// 演示 实例 计数 的 泛 型 类 

/// </summary> 

/// «typeparam name="T"> 用 于 数组 存储 的 类 型 参数 </typeparam> 


public class FixedSizeCollection<T> 


{ 

















/// <summary> 

/// 构造 国 数 ,增加 静态 计数 器 ,设置 内 部 存储 

/// </summary> 

/// <param name="items"></param> 

public FixedSizeCollection(int items) 

{ 
FixedSizeCollection<T>. InstanceCount++; 
this.Items = new T[items]; 


j 


/// <summary> 

/// 将 一 个 数据 项 添加 到 类 中 ,该 数据 项 的 类 型 由 实例 化 的 类 型 参数 确定 
/// </summary> 
/// <param name="item"> 要 添加 的 数据 项 </param> 

/// <returns> 新 添加 的 数据 项 的 从 9 开始 的 索引 </returns> 
public int AddItem(T item) 








{ 
if (this.ItemCount < this. Items.Length) 
{ 
this. Items[this.ItemCount] = item; 
return this.ItemCount++; 
} 
else 





throw new Exception("Item queue is full"); 


} 


/// <summary> 

/// 从 类 中 获得 一 个 数据 项 

/// </summary> 

/// <param name="index"> 要 获取 的 数据 项 的 从 9 开始 的 索引 </param> 
/// <returns> 实 例 化 的 类 型 的 一 个 数据 项 </returns> 

public T GetItem(int index) 





{ 
if (index >= this.Items.Length && 
index >= 0) 
throw new ArgumentOutOfRangeException(nameof(index)); 
return this.Items[index]; 
} 


#region Properties 

/// <summary> 

/// 静态 的 实例 计数 器 ,用 于 泛 型 类 实例 化 的 类 型 
/// </summary> 

public static int InstanceCount { get; set; } 























/// <summary> 

/// 类 中 包含 的 数据 项 的 数量 

/// </summary> 

public int ItemCount { get; private set; } 





/// <summary> 

/// 类 中 包含 的 数据 项 

{L| </summary> 

private T[] Items { get; set; } 
#endregion // Properties 





/// <summary> 
/// 重 写 ToString 以 提供 类 的 详细 信息 
{|| </summary> 
/// <returns> 包 含 类 详细 信息 、 格 式 化 过 的 字符 串 </returns> 
public override string ToString() => 
$"There are {FixedSizeCollection<T>.InstanceCount.ToString()} 
instances of {this.GetType().ToString()} and this instance 
contains {this.ItemCount} items..."; 




































































} 
当 你 查看 Items 数组 属性 的 实现 时 ，FixedSsizeCoLLection<T> 开始 变 得 有 些 不 同 了 。Items 
数组 声明 如 下 : 

private T[] Items { get; set; } 
而 不 是 : 

private object[] Items { get; set; } 


Items 数组 属性 使 用 泛 型 类 的 类 型 参数 (<T>) 来 确定 允许 哪些 类 型 的 数据 项 。 
FixedSizeCollection 用 object 作为 Items 数组 属性 的 类 型 ， 它 允许 把 任何 类 型 存储 在 数 
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据 项 的 数组 中 (因为 所 有 类 型 都 可 转换 为 object) ; 而 FixedSizeCollection<T> 通过 类 型 
参数 确定 允许 哪些 类 型 的 对 象 ， 从 而 提供 了 类 型 安全 。 另 外 要 注意 的 是 ， 这 些 属 性 没有 声 
明 相 关联 的 私有 字段 以 存储 数组 。 这 个 示例 使 用 了 C# 3.0 中 新 增 的 自动 实现 的 属性 。 在 底 
层 ，C# 编译 器 为 属性 对 应 的 类 型 创建 了 一 个 存储 元 素 ， 但 是 只 要 你 不 需要 在 访问 属性 时 
执行 特定 的 代码 ， 就 不 再 需要 为 此 属性 存储 编写 代码 。 要 使 属性 只 读 ， 只 要 将 set; 声明 标 














记 为 private 即 可 。 











在 AddItem 和 GetItem 的 方法 声明 中 可 以 看 出 另 一 个 区 别 。AddIten 现在 需要 类 型 为 T 的 一 


个 参数 ， 而 在 FixedSizeCollection 中 ， 它 需要 一 个 object 类 型 的 参数 。GetIten 现在 返回 
一 个 类 型 为 T 的 值 ， 而 在 FixedSizeCollection 中 ， 它 返回 一 个 object 类 型 的 值 。 

















这 些 改 





变 允许 FixedSizeCollection<T> 中 的 方法 使 用 实例 化 的 类 型 存储 和 获取 数组 中 的 数据 项 ， 


而 不 必 像 在 FixedSizeCollection 中 那样 允许 存储 任何 object, 


/// <summary> 








/// 将 一 个 数据 项 添加 到 类 中 ,该 数据 项 的 类 型 由 实例 化 的 类 型 参数 确定 





/// </summary> 

/// «param name="item"> 要 添加 的 数据 项 </param> 

/// <returns> 新 添加 的 数据 项 的 从 9 开始 的 索引 </returns> 
public int AddItem(T item) 











if (this.ItemCount < this. Items.Length) 


this.Items[this.ItemCount] = item; 
return this.ItemCount++; 


} 
else 
throw new Exception("Item queue is full"); 


} 


/// <summary> 


/// 从 类 中 获得 一 个 数据 项 
/// </summary> 











/// «param name="index"> 要 获取 的 数据 项 的 从 9 开始 的 索引 </param> 








/// <returns> 实 例 化 的 类 型 的 一 个 数据 项 </returns> 
public T GetItem(int index) 


{ 


if (index >= this.Items.Length && 
index >= 0) 
throw new ArgumentOutOfRangeException("index"); 


return this.Items[index]; 


} 


这 提供 了 儿 个 优势 。 首 先 最 重要 的 是 ，FixedsizeCollection<T> 为 数组 中 的 数据 项 提供 的 


类 型 安全 。 可 以 在 FixedSizeCollection 中 编写 如 下 代码 : 
// 常规 类 
FixedSizeCollection C = new FixedSizeCollection(5); 
Console.WriteLine(C); 





string si = "s1"; 
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string s2 = "s2"; 
string s3 = "s3"; 
int i1 = 1; 





// 添加 到 固定 大 小 的 集合 中 (作为 object) 
C.AddItem(s1); 

C.AddItem(s2); 

C.AddItem(s3); 

// 将 一 个 int 添 加 到 string 数 组 中 ,完全 没 问 题 
C.AddItem(i1); 


但 是 如 果 你 尝试 执行 相同 的 操作 ，FixedsizeCollection<T> 将 返回 一 个 错误 给 编译 器 。 
// 泛 型 类 


FixedSizeCollection<string> gC = new FixedSizeCollection<string>(5); 
Console.WriteLine(gC); 

















string s1 - "s1"; 
string s2 - "s2"; 
string s3 - "s3"; 
int i1 = 1; 


// 添加 到 泛 型 类 (作为 string) 

gC.AddItem(s1); 

gC.AddItem(s2); 

gC.AddItem(s3); 

// 试图 将 一 个 int 添 加 到 string 实 例 ,被 编译 器 拒绝 
// error CS1503: Argument '1': cannot convert from 'int' to 'string' 
//gC.AddItem(i1); 


由 编译 器 阻止 它 在 运行 时 导致 错误 是 个 非常 好 的 想法 。 


也 许 你 :并 不 会 立刻 注意 到 ， e AA UE. 
实际 会 对 整数 进行 装 箱 。 在 FixedSizeCollection 上 调用 GetItem 的 并 中 可 以 看 出 这 一 点 。 
IL 0177: ldloc.2 
IL 0178: ldloc.s i1 
IL, 017a: box [mscorlib]System.Int32 


IL 017f: callvirt instance int32 
CSharpRecipes.ClassesAndGenerics/FixedSizeCollection: :AddItem(object) 


一 装 箱 操作 把 值 类 型 的 int 转变 成 引用 类 型 (object) ， 以 便 存 储 在 数组 中 。 这 导致 在 
object 数组 中 保存 值 类 型 时 需要 额外 的 工作 。 


在 FixedSizeCollection 的 实现 中 从 类 取 回 一 个 数据 项 时 会 遇 到 另 一 个 问题 。 看 一 下 
FixedSizeCollection.GetItem 如 何 获取 一 个 数据 项 。 


// 保存 获取 的 string 


string sHolder; 






































// 需要 进行 转换 ,否则 会 出 现 错误 CS9266 ; 
// 无 法 隐 式 地 将 类 型 object 转 换 为 string 
sHolder = (string)C.GetItem(1); 


由 于 FixedSizeCollection.GetItem 返回 的 数据 项 是 object 类 型 ， 需 要 将 其 强制 转换 成 
string， 以 便 获 得 你 所 希望 的 用 于 索引 1 位 置 的 string。 它 可 能 并 不 是 一 个 string， 你 只 
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能 确定 它 是 一 个 object， 但 是 必须 将 它 强制 转换 成 一 种 更 具体 的 类 型 ， 才 可 以 正确 地 给 它 
赋值 。 
FixedSizeCollection<T> 的 实现 修正 了 这 些 问题 。 与 FixedSizeCollection 不 同 ，FixedSize- 
Collection<T> 中 并 不 需要 拆 箱 操 作 ， 因 为 GetItem 的 返回 类 型 是 实例 化 的 类 型 ， 编 译 器 通 
过 检查 将 要 返回 的 值 确保 了 这 一 点 。 

// 保存 获取 的 string 


string sHolder; 
int iHolder; 

















// 不 需要 类 型 转换 
sHolder = gC.GetItem(1); 


// 试图 将 一 个 string 保 存 到 ;int 变量 
// 错误 CS0029 :无 法 隐 式 地 将 类 型 ' string ' 转 换 为 "int' 
//iHolder = gC.GetItem(1); 


为 了 看 出 两 种 类 型 之 间 的 另 一 个 区 别 ， 分 别 实例 化 每 种 类 型 的 几 个 实例 ， 代 码 如 下 所 示 。 
// 常规 类 


FixedSizeCollection A = new FixedSizeCollection(5); 
Console.WriteLine(A); 
FixedSizeCollection B = new FixedSizeCollection(5); 
Console.WriteLine(B); 
FixedSizeCollection C = new FixedSizeCollection(5); 
Console.WriteLine(C); 





// 泛 型 类 

FixedSizeCollection<bool> gA = new FixedSizeCollection<bool>(5); 
Console.WriteLine(gA) ; 

FixedSizeCollection<int> gB = new FixedSizeCollection<int>(5); 
Console.WriteLine(gB) ; 

FixedSizeCollection<string> gC = new FixedSizeCollection<string>(5); 
Console.WriteLine(gC) ; 

FixedSizeCollection<string> gD = new FixedSizeCollection<string>(5); 
Console.WriteLine(gD); 


aR ROBUR EH ERR A P Bras 


There are 1 instances of CSharpRecipes.ClassesAndGenerics+FixedSizeCollection 
and this instance contains 0 items... 

There are 2 instances of CSharpRecipes.ClassesAndGenerics+FixedSizeCollection 
and this instance contains 0 items... 

There are 3 instances of CSharpRecipes.ClassesAndGenerics+FixedSizeCollection 
and this instance contains 0 items... 

There are 1 instances of CSharpRecipes.ClassesAndGenerics+FixedSizeCollection'1 
[System.Boolean] and this instance contains 0 items... 

There are 1 instances of CSharpRecipes.ClassesAndGenerics+FixedSizeCollection'1 
[System.Int32] and this instance contains 0 items... 

There are 1 instances of CSharpRecipes.ClassesAndGenerics+FixedSizeCollection'1 
[System.String] and this instance contains © items... 

There are 2 instances of CSharpRecipes.ClassesAndGenerics+FixedSizeCollection'1 
[System.String] and this instance contains © items... 











1.10.3 讨论 

即使 你 不 知道 将 要 处 理 的 最 终 类 型 ， 泛 型 中 的 类 型 参数 也 能 让 你 创建 类 型 安全 的 代码 。 在 
许多 实例 中 ， 你 希望 类 型 具有 某 些 特征 ， 在 这 种 情况 下 可 以 对 类 型 施加 一 些 限制 (参见 范 
例 1.12， 即 1.12 节 )。 方 法 可 以 具有 泛 型 类 型 参数 ， 而 不 管 类 自身 是 否 具 有 它们 。 

注意 常规 类 FixedSizeCollection 具有 三 个 实例 ， 而 泛 型 类 FixedSizeCollection<T> 有 一 
个 声明 为 bool 类 型 的 实例 ， 一 个 声明 为 int 的 实例 ， 两 个 声明 为 string 类 型 的 实例 。 这 
意味 着 每 个 非 泛 型 类 对 应 创建 了 一 个 .NET Type 对 象 ， 而 一 个 泛 型 类 的 每 个 类 型 实例 化 都 
创建 了 一 个 .NET Type 对 象 。 

在 示例 代码 中 ，FixedSizeCollection 具有 三 个 实例 ， 因 为 FixedSizeCollection 只 有 一 个 由 
CLR 维护 的 类 型 。 对 于 谤 型 ， 每 个 类 模板 与 类 型 实例 构造 时 传人 的 类 型 参数 的 组 合 都 维护 
了 一 个 类 型 。 换 句 话说， 你 得 到 了 一 个 用 于 FixedSizeCollection<bool> 的 .NET 类 型 ,一 个 
用 于 FixedSizeCollection<int> 的 .NET 类 型 ， 还 有 一 个 用 于 FixedSizeCollection<string> 
的 .NET 类 型 。 


静态 属性 InstanceCount 有 助 于 阐释 这 一 点 ， 因 为 类 的 静态 属性 实际 上 与 CLR 维护 的 类 型 
相关 联 。CLR 只 会 对 任何 给 定 的 类 型 创建 一 次 ， 然 后 维护 它 ， 直 到 应 用 程序 域 卸 载 。 这 也 
就 是 发 生 以 下 情况 的 原因 : 对 这 些 对 象 调用 ToString() 的 结果 显示 FixedSizeCollection 
的 计数 是 3 (因为 确实 只 有 其 中 1 个 计数 器 ) ， 而 FixedSizeCoLLection<T> 类 型 的 计数 器 是 
1 或 2。 






































1.104 ”参考 
MSDN 文档 中 的 “ 泛 型 类 型 参数 ”和 “ 泛 型 类 ”主题 ，。 


1.41 反 转 有 序列 表 中 的 内 容 


1.11.1. 问题 

你 希望 能 够 反 转 数据 项 的 有 序列 表 中 的 内 容 ， 并 且 还 能 够 同时 以 数组 和 列表 方式 访问 它 
们 ， 就 像 使 用 SortedList PIZ AYE SortedList<T> 那样 。SortedList 和 SortedList<T> 都 
没有 提供 除 重 加 载 列表 之 外 完成 该 任务 的 直接 方式 。 


1.11.2 解决 方案 


使 用 LINQ to Object 查询 SortedList<T>， 并 对 列表 中 的 信息 应 用 降序 排序 。 在 实例 化 一 个 
fk int, [fj string 的 SortedList<TKey, TValue» 之 后 ， 把 一 系列 无 序 的 数字 以 及 它们 
的 文本 表示 插入 列表 中 。 然 后 会 显示 这 些 数据 项 。 


SortedList<int, string> data = new SortedList<int, string>() 
{ [2]="two", [5]="five", [3]="three", [1]="one" }; 

















foreach (KeyValuePair<int, string> kvp in data) 
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{ 
Console.WriteLine($"\t {kvp.Key}\t{kvp.Value}"); 


} 


然后 以 升序 〈 默 认 情况 ) 排序 的 方式 显示 列表 的 输出 。 


one 
two 
three 
five 


WwWN Fe 


现在 ， 通 过 使 用 LINQ to Object 创建 一 个 查询 并 把 orderby 子 名 设置 为 descending 来 反 转 
排序 顺序 。 然 后 从 查询 结果 集中 显示 结果 : 




















// 降序 排序 查询 

var query = from d in data 
orderby d.Key descending 
select d; 





foreach (KeyValuePair<int, string» kvp in query) 




















{ 
Console.WriteLine($"\t {kvp.Key}\t{kvp.Value}"); 
} 
一 次 结果 以 降序 排序 显示 : 
5 five 
3 three 
2 two 
1 one 


当 把 


双 新 的 数据 项 添加 到 列表 中 时 ， 将 以 升序 的 排序 方式 添加 它 ， 但 是 通过 在 添加 了 所 有 数 














据 项 之 后 再 次 查询 列表 ， 可 以 使 列表 的 排序 方式 保持 不 变 





data.Add(4, "four"); 











// 降序 排序 重新 查询 

query = from d in data 
orderby d.Key descending 
select d; 


foreach (KeyValuePair<int, string> kvp in query) 


{ 
Console.WriteLine($"\t {kvp.Key}\t{kvp.Value}"); 


} 


Console.WriteLine(""); 





// 访问 原始 列表 以 升序 方式 显示 


foreach (KeyValuePair<int, string> kvp in data) 


{ 
Console.WriteLine($"\t {kvp.Key}\t{kvp.Value}"); 


} 


然后 可 以 在 以 升序 或 降序 排序 的 输出 中 看 到 新 添加 的 数据 项 : 





five 
four 
three 
two 
one 
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one 
two 
three 
four 
five 
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1.11.3 讨论 

SortedList 融合 了 数组 和 列表 的 语法 ， 人 允许 以 任何 一 种 方式 来 访问 数据 ， 用 起 来 很 方便 。 
可 以 以 键 值 对 或 者 直接 通过 索引 访问 数据 ， 并 且 不 允许 添加 重复 的 键 。 此 外 ， 引 用 或 可 空 
类 型 的 值 可 以 是 nuLL， 但 是 键 不 能 是 nuLL。 可 以 使 用 foreach 循环 迭代 访问 数据 项 ， 其 返 
回 类 型 是 KeyValuePair。 在 访问 SortedList<T> 的 元 素 时 ， 只 能 读 取 它们 。 通 常 的 迭代 器 
语法 禁止 在 读 取 列 表 中 的 元 素 时 更 新 或 删除 它们 ， 因 为 这 将 使 从 代 器 无 效 。 

查询 子 句 中 的 orderby 子 句 将 导致 查询 的 结果 集 以 升序 (默认 ) 或 降序 排序 。 这 种 排序 是 
使 用 针对 元 素 类 型 的 默认 比较 器 完成 的 ， 因 此 对 于 自 定 义 类 型 的 元 素 ， 可 以 通过 重 写 其 
Equals 方法 来 影响 它 。 可 以 为 orderby 子 句 指定 多 个 键 ， 因 为 它 具 鹏 套 排序 的 作用 ， 比 
如 先 按 “last name” 排 序 ， 再 按 “first name” HEF. 


1.11.4 参考 


MSDN 文档 中 的 “SortedList”“ 泛 型 KeyValuePair 结构 ”和 “ 泛 型 SortedList" W, 
1.12 约束 类 型 参数 


1.12.1 问题 
你 需要 用 一 种 类 型 参数 来 创建 泛 型 类 型 ， 该 类 型 参数 必须 支持 特定 接口 的 成 员 ， 如 


IDisposable, 


1.12.2 ”解决 方案 
使 用 约束 条 件 强制 要 求 泛 型 类 型 的 类 型 参数 是 一 种 实现 一 个 或 多 个 特定 接口 的 类 型 。 


public class DisposableList<T> : IList<T> 
where T : class, IDisposable 


{ 


private List<T> items = new List<T>(); 



























































// 私有 方法 ,处 置 列 表 中 的 元 素 


private void Delete(T item) => item.Dispose(); 
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// IList<T> Members 
public int IndexOf(T item) => _items.IndexO0f (item) ; 


public void Insert(int index, T item) => _items.Insert(index, item); 


public T this[int index] 


{ 
get {return (_items[index]);} 
set {_items[index] = value; } 
} 
public void RemoveAt(int index) 
{ 
Delete(this[index]); 
.items.RemoveAt(index); 
} 


// ICollection<T> Members 
public void Add(T item) =>  items.Add(item); 


public bool Contains(T item) => _items.Contains(item) ; 


public void CopyTo(T[] array, int arrayIndex) => 
_items.CopyTo(array, arrayIndex); 


public int Count =>  items.Count; 
public bool IsReadOnly => false; 


// TEnumerable<T> Members 
public IEnumerator<T> GetEnumerator()-»  items.GetEnumerator(); 


// TEnumerable Members 
IEnumerator IEnumerable.GetEnumerator()-» _items.GetEnumerator(); 


// Other members 
public void Clear() 


{ 
for (int index = 0; index < _items.Count; index++) 
{ 
Delete(_items[index]); 
} 
_items.Clear(); 
} 


public bool Remove(T item) 


{ 


int index = items.IndexOf(item); 


if (index >= 0) 

{ 
Delete(_items[index]); 
_items.RemoveAt(index) ; 





return (true); 


} 


else 


{ 
} 


return (false) 


} 





这 个 DisposableList 类 只 人 允许 用 一 个 实现 了 IDisposable 接 


5, 





口 的 对 象 作 为 类 型 参数 传 


入 。 其 原因 是 ， 无 论 何 时 从 DisposableList 对 象 中 删除 一 个 对 象 ， 都 会 在 该 对 象 上 调用 


Dispose 方法 。 这 人 允许 你 透明 地 管理 
































下 面 的 代码 用 到 了 DisposableList HR: 





public static void TestDis 


{ 


posableListCls() 


这 个 DisposableList 对 象 中 存储 的 任何 对 象 。 





DisposableList<StreamReader> dl = new DisposableList<StreamReader>(); 


// 创建 一 些 测试 对 象 
StreamReader tri 
StreamReader tr2 
StreamReader tr3 


// 将 测试 对 象 添加 到 Di 
dl.Add(tr1); 
dl.Insert(0, tr2); 
dl.Add(tr3); 


foreach(StreamReader 


{ 


sposableList 


sr in dl) 


new StreamReader("C:\\Windows\\system.ini"); 
new StreamReader("c:\\Windows\\vmgcoinstall. log"); 
new StreamReader("c:\\Windows\\Starter.xml"); 


Console.WriteLine($"sr.ReadLine() == {sr.ReadLine()}"); 


j 


// tgADisposablelist']| 
dl.RemoveAt(0); 
dl.Remove(tr1); 
dl.Clear(); 





1.42.3 讨论 














P 移 除 任何 可 处 置 的 对 象 之 前 调 ) 








Dispose 方 法 


where 关键 字 是 用 于 约束 类 型 参数 只 接受 满足 给 定 约束 条 件 的 参数 。 例 如 ，DisposableList 
约束 任何 类 型 参数 T 必须 实现 IDisposable 接口 。 





public class DisposableLis 
where T : IDispos 


这 意味 着 下 面 的 代码 将 成 功 地 编 


t<T> : IList<T> 
able 


DisposableList<StreamReader> dl = new DisposableList<StreamReader>(); 





但 是 下 面 的 代码 则 不 然 : 
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DisposableList<string> dl = new DisposableList<string>(); 
这 是 由 于 string 类 型 没有 实现 Disposable 接口 ， 而 StreamReader 类 型 则 实现 了 这 个 
接口 。 
除了 要 求实 现 一 个 或 多 个 特定 的 接口 之 外 ， 还 允许 对 类 型 参数 施加 其 他 约束 条 件 。 可 以 强 
制 类 型 参数 继承 自 特 定 的 基 类 (如 TextReader 类 ) 。 


public class DisposableList<T> : IList<T> 
where T : System.IO.TextReader, IDisposable 


还 可 以 确定 是 否 把 类 型 参数 限制 为 只 能 是 值 类 型 或 引用 类 型 。 下 面 的 类 声明 被 限制 为 只 使 
用 值 类 型 。 


public class DisposableList<T> : IList<T> 
where T : struct 


rix SF ie Bc AJA DCI ESEA 


public class DisposableList<T> : IList<T> 
where T : class 


此 外 ， 还 可 以 要 求 类 型 参数 实现 公开 的 默认 构造 函数 。 


public class DisposableList<T> : IList<T> 
where T : IDisposable, new() 


使 用 约束 条 件 允 许 编写 只 接受 一 组 小 范围 可 用 类 型 参数 的 泛 型 类 型 。 如 果 1.12.2 节 中 省 
W& T IDisposable 约束 条 件 ， 将 会 发 生 编译 时 错误 。 a a 
将 实现 IDisposable 接口 的 rore 类 的 类 型 参数 。 如 果 跳 过 这 个 编译 时 检查 ， 
DisposableList 对 象 就 可 能 包含 没有 公开 的 无 参 Dispose 方法 的 对 象 。 E DU. s 
会 发 生 运行 时 异常 。 泛 型 ， 是 约束 条 件 可 以 强制 对 类 型 的 参数 执行 严格 的 类 型 检查 

并 且 允 许 在 编译 时 而 非 运行 时 捕获 这 些 问题 。 

1.12.4 参考 


MSDN 文档 中 的 “where 关键 字 ” 主 题 。 


1.13 ”将 泛 型 变量 初始 化 为 默认 值 


1.13.1 问题 


“有 一 个 泛 型 类 ， 它 包含 一 个 变量 ， 其 类 型 与 类 自身 定义 的 类 型 参数 的 类 型 相同 。 在 构造 
世 型 对 象 时 ， 你 希望 将 该 变 量 初始 化 为 它 的 默认 值 。 


1.13.2 ”解决 方案 


简单 地 使 用 default 关键 字 将 该 变量 初始 化 为 它 的 默认 值 。 
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public class DefaultValueExample<T> 


{ 
T data = default(T); 
public bool IsDefaultData() 
{ 
T temp = default(T); 
if (temp.Equals(data) ) 
{ 
return (true); 
} 
else 
{ 
return (false); 
} 
} 
public void SetData(T val) => data = value; 
} 


使 用 这 个 类 的 代码 如 下 所 示 。 


public static void ShowSettingFieldsToDefaults() 



































{ 
DefaultValueExample<int> dv = new DefaultValueExample<int>(); 
// 检查 是 否 将 数据 设置 为 其 默认 值 ;返回 true 
bool isDefault = dv.IsDefaultData(); 
Console.WriteLine($"Initial data: {isDefault}"); 
// 设置 数据 
dv.SetData(100); 
// 再 次 检查 ,这 次 返回 的 是 false 
isDefault = dv.IsDefaultData(); 
Console.WriteLine($"Set data: {isDefault}"); 

} 


第 一 次 调用 IsDefaultData 将 返回 true， 而 第 二 次 调用 则 会 返回 false, fth Br. 


Initial data: True 
Set data: False 


1.13.3 讨论 

在 初始 化 与 泛 型 类 相同 的 类 型 参数 的 变量 时 ， 不 能 仅仅 把 该 变量 设置 为 nutl。 如 果 类 型 
(如 ;int 或 char) 会 发 生 什 么 情况 呢 ? 这 是 行 不 通 的 ， 因 为 值 类 型 不 
能 为 nuLL。 你 可 能 认为 可 以 把 可 空 类 型 (如 long? BY Nullable<long>) 设置 为 null (BY 
MSDN 文档 中 ace null 的 类 型 (CH 编程 指南 )” 了 解 可 空 类 型 的 更 多 信息 )。 不 
过 ， 编 译 器 无 法 知道 用 户 将 使 用 什么 类 型 参数 来 构造 类 型 。 

default 关键 字 人 允许 在 编译 时 告诉 编译 器 应 该 使 用 这 个 变量 的 默认 值 。 如 果 提 供 的 类 型 参 
数 是 一 个 数值 (例如 int、long、decimal)， 那 么 默认 值 将 是 0。 如果 提供 Pp rm 
种 引用 类 型 ， 那 么 默认 值 将 是 nuLL。 如 果 提 供 的 类 型 参数 是 一 个 struct， 那 么 通过 把 每 
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成 员 字段 初始 化 为 它们 的 默认 值 来 确定 该 struct 的 默认 值 。 




















1.13.4 84 


MSDN 文档 中 的 “使 用 可 以 为 null 的 类 型 (CH 编程 指南 )” 和 “ 泛 型 代码 中 的 默认 关键 
字 ” 主 题 。 


1.14 [8] 4E RA SE FR RMF 


1.14.1 问题 
你 有 一 种 生成 分 部 类 业务 实体 定义 的 过 程 ， 并 且 想 添加 一 种 轻 量 级 的 通知 机 制 。 


1.14.2 ”解决 方案 
使 用 分 部 方法 在 生成 的 代码 中 为 业务 实体 添加 钧 子 。 


生成 实体 的 过 程 可 能 来 自 于 UML、 数 据 集 或 者 其 他 对 象 建 模 工具 ， 但 是 当代 码 被 生成 为 
分 部 类 时 ， 为 调用 ChangingProperty 分 部 方法 的 属性 会 将 分 部 方法 挂 钓 添 加 到 模板 中 ， 如 
GeneratedEntity 类 中 所 示 。 




















public partial class GeneratedEntity 


{ 
public GeneratedEntity(string entityName) 
{ 
this.EntityName = entityName; 
} 


partial void ChangingProperty(string name, string originalValue, 
string newValue); 


public string EntityName { get; } 
private string _FirstName; 
public string FirstName 


{ 
get { return _FirstName; } 
set 
{ 
ChangingProperty("FirstName", FirstName, value) ; 
_FirstName = value; 
} 
} 


private string _State; 
public string State 
t 
get { return State; } 
set 
{ 
ChangingProperty("State", State,value); 
_State = value; 
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} 


GeneratedEntity 具有 两 个 属性 : FirstName 和 State。 注 意 其 中 每 个 属性 都 具有 相同 的 样板 
代码 ， 它 使 用 属性 的 名 称 、 原 始 值 和 新 值 调用 ChangingProperty 方法 。 如 果 此 时 使 用 生成 
的 类 ， 编 译 器 将 删除 ChangingProperty 的 声明 和 方法 ， 因 为 不 存在 ChangingProperty 的 实 
现 。 如 果 像 下 面 这 样 提 供 一 个 实现 来 报告 属性 变化 ， 那 么 将 保留 并 执行 ChangingProperty 
的 所 有 分 部 方法 代码 : 


public partial class GeneratedEntity 






































{ 
partial void ChangingProperty(string name, string originalValue, 
string newValue) 
{ 
Console.WriteLine($"Changed property ({name}) for entity " + 
S"{this.EntityName} from " + 
S"{originalValue} to {newValue}"); 
} 
} 


1.14.3 itit 
在 使 用 分 部 方法 时 ， 要 注意 以 下 几 点 。 


。 用 partial 修饰 符 指示 分 部 方法 。 

。 只 能 在 分 部 类 中 声明 分 部 方法 。 

。 分 部 方法 可 以 只 有 方法 声明 ， 而 没有 方法 体 。 

。 从 签名 角度 讲 ， 分 部 方法 可 以 包含 参数 ， 需 要 空运 回 值 ， 不 能 有 任何 访问 修饰 符 。 分 部 
意味 着 它 是 私有 方法 ， 并 且 可 以 是 静态 、 泛 型 或 者 不 安全 的 。 

。 对 于 泛 型 分 部 方法 ,约束 条 件 必 须 在 声明 和 实现 上 重复 标记 。 

。 分 部 方法 不 能 实现 接口 成 员 ， 因 为 接口 成 员 必 须 是 公共 的 。 

。 不 能 使 用 virtual, abstract, override, new, sealed gy extern 这 些 修饰 符 。 

。 分 部 方法 的 参数 不 能 使 用 out， 但 可 以 使 用 ref, 

分 部 方法 类 似 于 条 件 方法 ， 只 不 过 条 件 方法 中 总 会 包含 方法 定义 ， 其 至 当 条 件 未 满足 时 

也 是 如 此 。 如 果 没 有 匹配 的 实现 ,分 部 方法 将 不 会 保留 方法 定义 。 可 以 像 下 面 这 样 使 用 

1.14.2 节 中 的 代码 。 


public static void TestPartialMethods() 


( 















































Console.WriteLine("Start entity work"); 

GeneratedEntity entity = new GeneratedEntity("FirstEntity"); 
entity.FirstName = "Bob"; 

entity.State = "NH"; 

GeneratedEntity secondEntity = new GeneratedEntity("SecondEntity"); 
entity.FirstName = "Jay"; 

secondEntity.FirstName = "Steve"; 

secondEntity.State = "MA"; 

entity.FirstName = "Barry"; 
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secondEntity.State = "WA"; 
secondEntity.FirstName = "Matt"; 
Console.WriteLine("End entity work"); 


} 


在 提供 了 ChangingProperty 的 实现 时 ， 将 产生 以 下 输出 。 


Start entity work 


Changed property (FirstName) for entity FirstEntity from to Bob 

Changed property (State) for entity FirstEntity from to NH 

Changed property (FirstName) for entity FirstEntity from Bob to Jay 
Changed property (FirstName) for entity SecondEntity from to Steve 
Changed property (State) for entity SecondEntity from to MA 

Changed property (FirstName) for entity FirstEntity from Jay to Barry 
Changed property (State) for entity SecondEntity from MA to WA 

Changed property (FirstName) for entity SecondEntity from Steve to Matt 


End entity work 











在 没有 提供 ChangingProperty 的 实现 时 ， 将 产生 以 下 输出 。 





Start entity work 
End entity work 


1.14.4 ”参考 


MSDN 文档 中 的 “分 部 方法 ”和 “分 部 (方法 ) ”主题 。 


1.15 控制 如 何 触发 多 播 委 托 中 的 一 个 委托 


1.15.1 问题 





你 组 合 了 多 个 委托 来 创建 一 个 多 播 委 托 。 当 调用 这 个 多 播 委托 时 ， 将 依次 调用 其 中 的 每 个 
委托 。 你 需要 施加 更 多 的 控制 。 例 如 ， 调 用 每 个 委托 的 顺序 ， 只 触发 一 个 委托 子 集 或 者 基 


于 前 一 个 委托 成 功 与 否 来 触发 每 个 委托 。 此 外 ， 你 需要 能 够 单独 处 理 每 个 委托 的 返回 值 。 


1.15.2 ”解决 方案 



































使 用 GetInvocationList 方法 获得 Delegate 对 象 的 数组 。 接 下 来 ， 使 用 for 循环 (如果 以 
非 标准 顺序 进行 枚 举 ) 或 foreach 循环 〈 如 果 以 标准 顺序 进行 枚 举 ) 遍历 这 个 数组 。 然 后 
可 以 逐个 调用 数组 中 的 每 个 Delegate 对 象 ， 并 且 可 以 获取 每 个 委托 的 返回 值 。 


























在 C# 中 ， 所 有 委托 类 型 都 支持 多 播 ， 也 就 是 说 ,多 
次 调用 时 都 可 以 调用 多 个 方法 。 在 本 范例 中 ， 我 们 
为 调用 多 个 方法 的 委托 。 


下 面 的 方法 创建 一 个 名 为 allInstances 的 多 播 委 托 











7 




















I 果 这 样 设置 ， 那 么 任何 委托 实例 在 每 








全 用 术语 多 播 (multicast) 来 描述 设置 





， 然 后 使 用 GetInvocationList 以 逆序 


逐一 调用 每 个 委托 。Func<int> 泛 型 委托 用 于 创建 返回 int 的 委托 实例 。 


public static void InvokeInReverse() 


{ 
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Func<int> myDelegateInstancel = TestInvokeIntReturn.Method1; 
Func<int> myDelegateInstance2 = TestInvokeIntReturn.Method2; 
Func<int> myDelegateInstance3 = TestInvokeIntReturn.Method3; 


Func<int> allInstances = 
myDelegateInstance1 + 
myDelegateInstance2 + 
myDelegateInstance3; 


Console.WriteLine("Fire delegates in reverse"); 
Delegate[] delegateList = allInstances.GetInvocationList(); 
foreach (Func<int> instance in delegatelist.Reverse()) 


{ 
} 


instance(); 


} 
注意 ， 为 了 翻转 使 用 GetInvocationList 得 到 的 委托 列表 ， 我 们 使 用 了 TEnumerable<T> 的 
扩展 方法 Reverse， 以 枚 举 通常 产生 数据 项 时 的 相反 顺序 获得 它们 。 


如 下 面 的 方法 所 示 ， 通 过 触发 每 隔 一 个 的 委托 ， 你 不 必 调 用 列表 中 的 所 有 委托 。 
InvokeEveryOtherOperation 使 用 此 处 为 IEnumerable<T> 创建 的 名 为 EveryOther 的 扩展 方 
法 ， 该 方法 从 枚 举 中 每 隔 一 个 数据 项 进行 返回 。 





























如 果 使 用 单 播 委托 ， 并 且 对 它 调用 GetInvocationList， 将 会 获得 一 个 包含 音 
一 委托 实例 的 列表 。 








n 





public static void InvokeEveryOtherOperation() 

{ 
Func<int> myDelegateInstancei = TestInvokeIntReturn.Method1; 
Func<int> myDelegateInstance2 = TestInvokeIntReturn.Method2; 
Func<int> myDelegateInstance3 = TestInvokeIntReturn.Method3; 


Func<int> allInstances = myDelegateInstancel + 
myDelegateInstance2 + 
myDelegateInstance3; 


Delegate[] delegateList = allInstances.GetInvocationList(); 
Console.WriteLine("Invoke every other delegate"); 
foreach (Func<int> instance in delegatelist.EveryOther()) 


// 调用 委托 
int retVal = instance(); 
Console.WriteLine($"Delegate returned {retVal}"); 


} 


static IEnumerable<T> EveryOther<T>(this IEnumerable<T> enumerable) 


( 


bool retNext - true; 
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foreach (T t in enumerable) 














{ 
if (retNext) yield return t; 
retNext = !retNext; 
} 
} 
下 面 的 类 包含 被 多 播 委 托 allInstances 调用 的 所 有 方法 。 
public class TestInvokeIntReturn 
{ 
public static int Method1() 
{ 
Console.WriteLine("Invoked Method1"); 
return 1; 
} 
public static int Method2() 
{ 
Console.WriteLine("Invoked Method2"); 
return 2; 
} 
public static int Method3() 
{ 
Console.WriteLine("Invoked Method3"); 
return 3; 
} 
} 








还 可 以 基于 当前 触发 委托 的 返回 值 来 决定 是 否 继续 触发 列表 中 的 委托 。 下 面 的 方法 将 会 触 
KET FE, MAZE false 时 才 会 停止 。 


public static void InvokeWithTest() 

















I 





























{ 
Func<bool> myDelegateInstanceBool1 = TestInvokeBoolReturn.Method1; 
Func<bool> myDelegateInstanceBool2 = TestInvokeBoolReturn.Method2; 
Func<bool> myDelegateInstanceBool3 = TestInvokeBoolReturn.Method3; 
Func<bool> allInstancesBool = 
myDelegateInstanceBool1 + 
myDelegateInstanceBool2 + 
myDelegateInstanceBool3; 
Console.WriteLine( 
"Invoke individually (Call based on previous return value):"); 
foreach (Func<bool> instance in allInstancesBool.GetInvocationList()) 
{ 
if (!instance()) 
break; 
} 
} 
下 面 的 类 包含 被 多 播 委 托 allInstancesBool 调用 的 所 有 方法 。 
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public class TestInvokeBoolReturn 


{ 

public static bool Method1() 

{ 
Console.WriteLine("Invoked Methodi"); 
return true; 

} 

public static bool Method2() 

{ 
Console.WriteLine("Invoked Method2") ; 
return false; 

} 

public static bool Method3() 

{ 
Console.WriteLine("Invoked Method3") ; 
return true; 

} 


1.15.3 iit 


当 一 个 委托 被 调用 时 ， 它 将 调用 其 调用 列表 内 存储 的 所 有 委托 。 这 些 委 托 通常 是 按 添 加 顺 
序 和 逐一 调用 的 。 使 用 MulticastDelegate 类 的 GetInvocationList 方法 ， 可 以 获得 多 播 委托 
的 调用 列表 中 的 每 个 委托 。 该 方法 不 接受 任何 参数 ， 并 且 返 回 Delegate 对 象 的 数组 ， 对 应 
于 调用 此 方法 的 委托 对 象 的 调用 列表 。 返 回 的 Delegate 数组 包含 调用 列表 中 的 委托 ， 其 排 
列 顺序 是 通常 调用 它们 的 顺序 ， 也 就 是 说 ，Delegate 数组 中 的 第 一 个 元 素 包含 一 般 情 况 下 
最 先 调用 的 Delegate 对 象 。 


GetInvocationList 方法 的 这 种 应 用 可 让 你 精确 控制 何 时 以 及 如 何 调用 多 播 委 托 中 的 委托 ， 
并 且 在 一 个 委托 失败 时 允许 你 阻止 继续 调用 委托 。 如 果 每 个 委托 都 在 操作 数据 ， 并 且 其 中 
一 个 委托 在 履行 其 职责 时 失败 但 是 没有 引发 异常 ， 那 么 这 种 能 力 就 很 重要 了 。 如 果 一 个 委 
托 在 履行 其 职责 时 失败 ， 并 且 其 余 的 委托 依赖 前 面 所 有 的 委托 来 成 功 履行 其 职责 ， 就 必须 
在 失败 时 停止 调用 委托 。 


此 范例 更 加 高 效 地 处 理 了 委托 失败 ， 还 在 处 理 这 些 错 误 时 提供 了 更 多 的 灵活 性 。 例 如 ， 可 
以 编写 逻辑 以 基于 之 前 调用 委托 的 返回 值 来 指定 要 调用 哪些 委托 。 下 面 的 方法 调用 一 个 名 
为 ALL 的 多 播 委 托 ， 然 后 使 用 GetInvocationList 单独 触发 每 个 委托 。 在 触发 每 个 委托 后 ， 
和 获 其 返回 值 。 


public static void TestIndividuallnvokesReturnValue() 


{ 
Func<int> myDelegateInstancel = TestInvokeIntReturn.Method1; 
Func<int> myDelegateInstance2 = TestInvokeIntReturn.Method2; 
Func<int> myDelegateInstance3 = TestInvokeIntReturn.Method3; 



























































Func<int> allInstances = 
myDelegateInstance1 + 
myDelegateInstance2 + 
myDelegateInstance3; 
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Console.WriteLine("Invoke individually (Obtain each return value):"); 
foreach (Func<int> instance in allInstances.GetInvocationList()) 
{ 
int retVal = instance(); 
Console.WriteLine($"\tOutput: {retVal}"); 
} 
} 


多 播 委托 的 一 个 怪异 之 处 是 ， 如 果 其 调用 列表 内 的 任意 或 所 有 委托 返回 了 一 个 值 ， 那 么 只 
会 返回 最 后 一 个 所 调用 委托 的 返回 值 ， 所 有 其 他 值 都 会 丢失 。 这 可 能 会 令 人 苦恼 ， 如 有 果 代 
码 需要 这 些 返 回 值 ， 事 情 会 变 得 更 糟 。 考 虑 像 通常 那样 调用 aLLInstances 委托 的 情况 ， 如 
下 面 的 代码 所 示 。 


retVal = allInstances(); 
Console.WriteLine(retValL) ; 


这 将 会 显示 值 3， 因 为 Method3 是 allInstances 委托 调用 的 最 后 一 个 方法 。 所 有 其 他 返回 
值 都 不 会 被 捕获 。 


通过 使 用 MulticastDelegate 类 的 GetInvocationList 方法 ， 可 以 绕 过 这 种 限制 。 该 方法 返 
回 Delegate 对 象 的 数组 ， 其 中 每 个 对 象 都 可 以 单独 进行 调用 。 注 意 ， 该 方法 不 会 调用 每 个 
委托 ， 而 是 只 会 把 它们 的 数组 返回 给 调用 者 。 通 过 单独 调用 每 个 委托 ， 可 以 从 每 个 调用 的 
委托 获取 每 个 返回 值 。 


注意 在 调用 多 播 委托 时 ， 所 有 out 或 ref 参数 都 会 丢失 。 此 范例 使 得 你 可 以 获得 多 播 委托 
内 每 个 调用 委托 的 out 和 /或 ref 参数 。 


尽管 如 此 ， 你 仍然 需要 意识 到 ， 从 其 中 一 个 调用 委托 中 发 生 的 任何 未 处 理 异 常 都 会 冒 泡 到 
本 范例 中 展示 的 TestIndividualInvokesReturnValue 方法 。 如 果 在 多 播 委 托 内 调用 的 委托 
中 发 生 异 常 并 且 该 异常 未 处 理 ， 就 不 会 调用 任何 余下 的 委托 。 这 是 多 播 委托 预期 的 行为 。 
不 过 ， 在 某 些 情况 下 ， 你 希望 能 够 处 理 各 个 委托 中 引发 的 异常 ， 然 后 在 那 一 刻 决 定 是 否 继 
续 调用 余下 的 委托 。 




























































































异常 将 强制 停止 调用 委托 。 异 常 应 该 仅 用 于 异常 情况 ， 不 应 该 用 于 控制 流程 。 











在 如 下 的 TestIndividualInvokesExceptions 方法 中 ， 如 果 捕 获 到 一 个 异常 ， 就 会 把 它 记 录 
到 事件 日 志 中 并 显示 它 ， 然 后 代码 继续 调用 委托 。 


public static void TestIndividuallnvokesExceptions() 


{ 





Func<int> myDelegateInstancel = TestInvokeIntReturn.Method1; 
Func<int> myDelegateInstance2 = TestInvokeIntReturn.Method2; 
Func<int> myDelegateInstance3 = TestInvokeIntReturn.Method3; 


Func<int> allInstances = 
myDelegateInstance1 + 
myDelegateInstance2 + 
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myDelegateInstance3; 


Console.WriteLine("Invoke individually (handle exceptions):"); 





// 创建 一 个 封装 异常 的 实例 以 包含 委托 实例 调用 中 遇 到 的 任何 异常 


List<Exception> invocationExceptions = new List<Exception>(); 


foreach (Func<int> instance in allInstances.GetInvocationList()) 





{ 
try 
{ 
int retVal = instance(); 
Console.WriteLine($"\tOutput: {retVal}"); 
} 
catch (Exception ex) 
t 
// 显示 并 记录 异常 ,然后 继续 执行 
Console.WriteLine(ex.ToString()); 
EventLog myLog = new EventLog(); 
myLog.Source = "MyApplicationSource"; 
myLog.WriteEntry( 
$'Failure invoking {instance.Method.Name} with error " + 
$"{ex.ToString()}", 
EventLogEntryType.Error); 
// 将 此 异常 添加 到 列表 
invocationExceptions.Add(ex); 
} 
} 


// 如 果 捕 获 了 任何 异常 ,引发 包含 所 有 异常 的 封装 异常 
if (invocationExceptions.Count > 0) 


{ 
} 


throw new MulticastInvocationException(invocationExceptions); 


} 


可 以 向 上 述 的 MulticastInvocationException 类 中 添加 多 个 异常 。 它 通过 InvocationExceptions 


属性 公开 一 个 ReadonlyCollection<Exception>， 如 下 所 示 。 





[Serializable] 
public class MulticastInvocationException : Exception 


( 


private List<Exception> _invocationExceptions; 


public MulticastInvocationException() 
: base() 

{ 

} 


public MulticastInvocationException( 
IEnumerable«Exception» invocationExceptions) 


{ 
} 


_invocationExceptions = new List<Exception>(invocationExceptions) ; 


public MulticastInvocationException(string message) 
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: base(message) 
{ 
} 


public MulticastInvocationException(string message, Exception innerException) 


:base(message,innerException) 


{ 
} 
protected MulticastInvocationException(SerializationInfo info, 
StreamingContext 
context) : 
base(info, context) 
{ 
_invocationExceptions = 
(List«Exception»)info.GetValue("InvocationExceptions", 
typeof(List«Exception»)); 
} 


[SecurityPermissionAttribute(SecurityAction.Demand, 
SerializationFormatter = true)] 

public override void GetObjectData( 
SerializationInfo info, StreamingContext context) 


{ 


info.AddValue("InvocationExceptions", this.InvocationExceptions) ; 


base.GetObjectData(info, context); 


} 


public ReadOnlyCollection<Exception> InvocationExceptions => 


new ReadOnlyCollection<Exception>(_invocationExceptions) ; 


} 
这 种 策略 允许 根据 需要 对 异常 进行 细 粒 度 的 处 理 。 一 种 选择 是 把 在 委托 处 理 期 间 发 生 的 所 


有 异常 都 存储 起 来 ， 然 后 把 处 
完成 之 后 ， 引 发 这 个 自 定义 的 异常。 
通过 向 这 个 try-catch 块 中 添加 一 个 Finally 块 ， 可 以 确保 在 每 个 委托 返回 后 执行 这 个 
Finally 块 内 的 代码 。 如 果 想 在 调用 委托 的 代码 之 间 穿插 一 些 代码 (比如 用 于 清 要 















































E 期 间 遇 到 的 所 有 异常 包装 在 一 个 自 定义 的 异常 中 。 在 处 理 
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对 象 的 代码 ， 或 者 用 于 验证 每 个 委托 用 到 的 数据 是 否 保持 稳定 状态 的 代码 ) ， 这 种 技术 就 





很 有 月 


H. 


1.15.4 参考 


MSDN 文档 中 的 “Delegate %” Fl “Delegate.GetInvocationList 方法 ”主题 。 


1.1 


6 在 C# 中 使 用 闭 包 


1.16.1 问题 
你 希望 把 少量 状态 与 某 种 行为 关联 起 来 ， 但 不 会 陷入 构建 新 类 的 麻烦 之 中 。 











1.16.2 ”解决 方案 


f FA lambda 表达 式 实 现 闲 包 。 闭 包 是 声明 时 捕获 作用 域 中 环境 状态 的 函数 。 简 单 地 讲 ， 
它们 是 当前 状态 以 及 某 种 可 以 读 取 和 修改 该 状态 的 行为 。lambda 表达 式 能 够 捕获 外 部 变量 


并 延长 它们 的 生存 期 ， 这 使 得 闭 包 可 以 在 C# 中 使 用 。 








关于 lambda 表达 式 的 更 多 信息 ， 请 参考 4.0 节 。 








作为 困 包 的 一 个 示例 ， 我 们 将 构建 一 个 快速 报告 系统 ， 用 于 跟踪 销售 人 员 及 其 收益 和 佣 

















金 。 闭 包 的 行为 是 ， 你 可 以 构建 一 些 代 码 ， 用 于 计算 每 个 季度 的 佣金 并 且 用 于 每 个 销售 


人 员 。 
首先 ， 必 须 定义 销售 人 员 ， 代 码 如 下 所 示 。 


class SalesPerson 
{ 
// CTORAY 
public SalesPerson() 
{ 
} 


public SalesPerson(string name, 
decimal annualQuota, 
decimal commissionRate) 





{ 
this.Name = name; 
this.AnnualQuota = annualQuota; 
this.CommissionRate = commissionRate; 
} 
// 私有 成 员 
decimal _commission; 
// 属性 


public string Name { get; set; } 
public decimal AnnualQuota { get; set; } 
public decimal CommissionRate { get; set; } 


public decimal Commission 


get { return _commission; } 

set 
_commission = value; 
this.TotalCommission += commission; 
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public decimal TotalCommission {get; private set; } 











} 
HE A AEA, FEEN, Wa. DORT EE LE. BE 




















然 有 一 些 事情 要 做 ， 就 让 我 们 编写 一 些 代码 来 计算 佣金 。 


delegate void CalculateEarnings(SalesPerson sp); 


static CalculateEarnings GetEarningsCalculator(decimal quarterlySales, 
decimal bonusRate) 











{ 
return salesPerson => 
{ 

// 计算 satesPerson 的 季度 指标 

decimal quarterLyQuota = (salesPerson.AnnualQuota / 4); 

// 他 达成 季度 指标 了 吗 

if (quarterlySales < quarterlyQuota) 

{ 
// 未 达成 指标 ,没有 佣金 
salesPerson.Commission = 0; 

} 

// 检查 奖金 级 别 的 绩效 (指标 的 200%) 

else if (quarterlySales > (quarterlyQuota * 2.0m)) 

{ 
decimal baseCommission = quarterlyQuota * 
salesPerson.CommissionRate; 
salesPerson.Commission = (baseCommission + 

((quarterlySales - quarterlyQuota) * 
(salesPerson.CommissionRate * (1 + bonusRate)))); 

} 

else // 常规 的 佣金 

{ 
salesPerson.Commission = 

salesPerson.CommissionRate * quarterlySales; 
} 
IE 
} 


将 委托 类 型 声明 为 CalculationEarnings， 它 接受 一 个 SalesPerson 类 型 参数 。 有 一 个 名 
为 GetEarningsCalculator 的 工厂 方法 ， 用 于 构造 此 委托 类 型 的 一 个 实例 。 它 将 创建 一 个 
lambda 表达 式 来 计算 SalesPerson 的 佣金 ， 并 返回 一 个 CalculateEarnings 的 实例 。 


在 开始 前 ， 必 须 创 建 salespeople 数组 ， 代 码 如 下 所 示 。 


// 设 定 salespeople…… 

SalesPerson[] salesPeople = { 
new SalesPerson { Name="Chas", AnnualQuota=100000m, CommissionRate=0.10m }, 
new SalesPerson { Name="Ray", AnnualQuota-200000m, CommissionRate=0.025m }, 
new SalesPerson { Name="Biff", AnnualQuota-50000m, CommissionRate-0.001m }}; 


然后 基于 每 季度 的 收入 建立 收入 计算 器 ， 代 码 如 下 所 示 。 


public class QuarterlyEarning 


{ 





Tet 








public string Name { get; set; } 





public decimal Earnings { get; set; } 
public decimal Rate { get; set; } 
} 
QuarterlyEarning[] quarterlyEarnings = 
{ new QuarterlyEarning(){ Name="Q1", Earnings = 65000m, Rate = 0.1m }, 
new QuarterlyEarning(){ Name="Q2", Earnings = 20000m, Rate = 0.1m }, 
new QuarterlyEarning(){ Name="Q3", Earnings = 37000m, Rate = 0.1m }, 
new QuarterlyEarning(){ Name="Q4", Earnings = 110000m, Rate = 0.15m} 


a 
var calculators - from e in quarterlyEarnings 
select new 
{ 
Calculator = 


GetEarningsCalculator(e.Earnings, e.Rate), 
QuarterlyEarning = e 


F 
最 后 ， 统 计 每 个 季度 的 所 有 salespeople 数值 ， 然 后 通过 该 数据 调用 WriteCommission- 
Report 生成 年 度 报告 。 这 将 告诉 主管 人 员 哪 些 销售 人 员 值 得 留 下 。 


decimal annualEarnings = 0; 
foreach (var c in calculators) 


{ 
WriteQuarterlyReport(c.QuarterlyEarning.Name, 
c.QuarterlyEarning.Earnings, c.Calculator, salesPeople); 
annualEarnings += c.QuarterlyEarning.Earnings; 
} 


// 看 一 下 谁 值得 留 下 


WriteCommissionReport(annualEarnings, salesPeople); 
WriteQuarterlyReport 为 每 个 SalesPerson 调用 CalculateEarnings 的 lambda 表达 式 实 现 
(eCaLc)， 并 且 基 于 每 个 销售 人 员 的 佣金 率 来 修改 状态 以 对 每 季度 的 佣金 进行 赋值 。 
static void WriteQuarterlyReport(string quarter, 
decimal quarterlySales, 


CalculateEarnings eCalc, 
SalesPerson[] salesPeople) 





























{ 
Console.WriteLine($"{quarter} Sales Earnings on Quarterly Sales of 
{quarterlySales.ToString("C")}:"); 
foreach (SalesPerson salesPerson in salesPeople) 
{ 
// 计算 佣金 
eCalc(salesPerson) ; 
// 报告 
Console.WriteLine($"\tSales person {salesPerson.Name} " + 
"made a commission of : " + 
$"(salesPerson.Commission.ToString("C")]"); 
} 
} 


























WriteCommissionReport 对 比 检查 各 个 销售 人 员 的 佣金 及 其 所 实现 的 收益 。 如 果 佣 金 超过 了 
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其 产生 收益 的 20%， 就 要 采取 建议 的 动作 。 


static void WriteCommissionReport(decimal annualEarnings, 
SalesPerson[] salesPeople) 




















{ 
decimal revenueProduced = ((annualEarnings) / salesPeople.Length); 
Console.WriteLine(""); 
Console.WriteLine($"Annual Earnings were {annualEarnings.ToString("C")}"); 
Console.WriteLine(""); 
var whoToCan = from salesPerson in salesPeople 
select new 
// 如 果 佣 金 超过 了 他 产生 收入 的 26%, 解雇 他 
CanThem = (revenueProduced * 0.2m) < 
salesPerson.TotalCommission, 
salesPerson.Name, 
salesPerson.TotalCommission 
E 
foreach (var salesPersonInfo in whoToCan) 
{ 

Console.WriteLine($"\t\tPaid {salesPersonInfo.Name} " + 
$"{salesPersonInfo. TotalCommission.ToString("C")} to produce" + 
$"{revenueProduced.ToString("C")}"); 

if (salesPersonInfo.CanThem) 

{ 

Console.WriteLine($"\t\t\tFIRE {salesPersonInfo.Name}!"); 

} 

} 
} 
下 面 列 出 了 收益 和 佣金 跟踪 程序 的 输出 。 

Q1 Sales Earnings on Quarterly Sales of $65,000.00: 
SalesPerson Chas made a commission of : $6,900.00 
SalesPerson Ray made a commission of : $1,625.00 
SalesPerson Biff made a commission of : $70.25 

Q2 Sales Earnings on Quarterly Sales of $20,000.00: 
SalesPerson Chas made a commission of : $0.00 
SalesPerson Ray made a commission of : $0.00 
SalesPerson Biff made a commission of : $20.00 

Q3 Sales Earnings on Quarterly Sales of $37,000.00: 
SalesPerson Chas made a commission of : $3,700.00 
SalesPerson Ray made a commission of : $0.00 
SalesPerson Biff made a commission of : $39.45 

Q4 Sales Earnings on Quarterly Sales of $110,000.00: 
SalesPerson Chas made a commission of : $12,275.00 
SalesPerson Ray made a commission of : $2,975.00 
SalesPerson Biff made a commission of : $124.63 

Annual Earnings were $232,000.00 

Paid Chas $22,875.00 to produce $77,333.33 
FIRE Chas! 
60 | 第 1 章 


Paid Ray $4,600.00 to produce $77,333.33 
Paid Biff $254.33 to produce $77,333.33 


1.16.3 讨论 


对 C# HP LA ee Hit S Z — TEM RAMA SB 2875 i, FHM MAS 
函数 关联 的 一 组 数据 。 如 果 需 要 对 相同 的 数据 执行 多 种 不 同 的 操作 ， 使 用 对 象 可 能 更 有 意 
义 一 些 。 它 们 是 处 理 相同 问题 的 两 种 不 同 角度 ， 要 解决 的 问题 类 型 有 助 于 决定 用 哪个 方法 
更 合适 。 它 只 依赖 你 倾向 于 选择 哪 种 方法 。 有 时候 ， 百 分 之 百 纯 面 向 对 象 编程 可 能 是 元 长 
乏味 而 且 不 必要 的 ， 可 以 使 用 闭 包 很 好 地 解决 其 中 一 些 问题 。 这 里 展示 的 SalesPerson {ff 
金 示例 演示 了 可 以 利用 团 包 做 什么 。 不 使 用 它们 也 可 以 完成 任务 ， 但 是 其 代价 是 要 编写 更 
多 的 类 和 方法 代码 。 


之 前 对 闭 包 已 经 进行 了 定义 ， 但 是 有 一 种 更 严格 的 定义 : 它 实质 上 意味 着 与 状态 关联 的 行 
为 不 应 该 能 够 修改 状态 ， 以 便 使 之 成 为 真正 的 闭 包 。 我 们 倾向 于 赞同 第 一 种 定义 ， 因 为 它 
表达 了 财 包 应 该 是 什么 ， 而 不 是 闭 包 应 该 如 何 实 现 ， 后 者 的 限制 性 过 强 。 无 论 你 选择 将 其 
视 为 lambda 表达 式 某 个 方面 的 优雅 特性 ， 还 是 觉得 值得 将 它 称 作 闭 包 ， 它 都 是 工具 箱 中 
的 又 一 种 编程 技巧 ， 不 应 该 被 握 弃 。 



























































1.16.4 参考 
范例 1.17 ( 即 1.17 节 ) 和 MSDN 文档 中 的 “lambda 表达 式 ” 主 题 。 


1.17 ”使 用 函数 对 象 在 列表 中 执行 多 种 操作 


1.17.1 问题 
你 希望 能 够 同时 对 整个 对 象 集 合 执行 多 种 操作 ， 并 在 功能 上 隔离 这 些 操作 。 


1.17.2 ”解决 方案 

使 用 函数 对 象 (functor x function object) 作为 转换 集合 的 工具 。 国 数 对 象 是 任何 一 个 
可 以 作为 国 数 被 调用 的 对 象 。 例 如 ， 委 托 、 国 数 、 国 数 指针 ， 甚 至 是 C/C++ 中 定义 了 
operator() 的 对 象 。 

在 软件 中 ， 经 党 需要 对 一 个 集合 执行 多 种 操作 。 假 定 你 的 股票 组 合 包含 了 一 系列 股票 。 
StockPortfolio 类 包含 一 个 Stock 对 象 的 List， 并 且 能 够 添加 股票 。 


public class StockPortfolio : IEnumerable<Stock> 


( 

















List<Stock> stocks; 


public StockPortfolio() 
{ 


} 


_stocks = new List<Stock>(); 
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} 


public void Add(string ticker, double gainLoss) 


{ 
} 


_stocks.Add(new Stock() {Ticker=ticker, GainLoss=gainLoss}); 


public IEnumerable<Stock> GetWorstPerformers(int topNumber) => 
_stocks.OrderBy((Stock stock) => stock.GainLoss).Take(topNumber); 


public void SellStocks(IEnumerable«Stock» stocks) 


{ 
foreach(Stock s in stocks) 
_stocks.Remove(s); 
} 
public void PrintPortfolio(string title) 
{ 
Console.WriteLine(title) ; 
_stocks.DisplayStocks(); 
} 


#region IEnumerable<Stock> Members 
public IEnumerator<Stock> GetEnumerator() => _stocks.GetEnumerator(); 
#endregion 


#region IEnumerable Members 
IEnumerator IEnumerable.GetEnumerator() => this.GetEnumerator(); 
#endregion 


Stock 类 相当 简单 。 只 需要 一 个 股票 代码 及 其 利润 或 亏损 百分比 。 


public class Stock 


{ 


} 








public double GainLoss { get; set; } 
public string Ticker { get; set; } 


要 使 用 这 个 StockPortfoLtio， 可 以 向 其 中 添加 几 支 带 利 润 / SH eR, H 


始 股票 组 合 。 有 了 这 个 股票 组 合 ， 


F 输 出 初 




















出 股票 来 改进 股票 组 合 ， 然 后 再 次 输出 它 。 


StockPortfolio tech = new StockPortfolio() { 


{"0U81", -10.5}, 
{"C#6VR", 2.0), 

{"PCKD", 12.3}, 

{"BTML", 0.5}, 

{"NOVB", -35.2}, 
{"MGDCD", 15.7}, 
{"GNRCS", 4.0}, 
{"FNCTR", 9.16}, 
{"LMBDA", 9.12}, 
{"PCLS", 6.11}}; 


tech.PrintPortfolio("Starting Portfolio"); 


你 希望 得 到 三 支 表现 最 差 股票 的 列表 ， 以 便 可 以 通过 卖 














// 出 售 表 现 最 差 的 3 支 股 票 

var worstPerformers = tech.GetWorstPerformers(3); 
Console.WriteLine("Selling the worst performers:"); 
worstPerformers.DisplayStocks(); 


tech.SellStocks(worstPerformers); 
tech.PrintPortfolio("After Selling Worst 3 Performers"); 


迄今 为 止 ,没有 发 生 任何 特别 令 人 感 兴趣 的 事情 。 通 过 查看 GetWorstPerformers 方法 的 内 
部 代码 ， 看 一 下 如 何 查 明 三 支 最 差 的 股票 。 


public IEnumerable<Stock> GetWorstPerformers(int topNumber) => _stocks.OrderBy( 
(Stock stock) => stock.GainLoss).Take(topNumber ) ; 


首先 通过 调用 TEnumerable<T> 的 OrderBy 扩展 方法 确保 列表 有 序 ， 以 便 将 表现 最 差 的 股票 
列 在 列表 的 前 面 。0rderBy 方法 接受 一 个 lambda 表达 式 ， 它 提供 了 用 于 比较 的 利润 /亏损 
百分比 ， 以 找 出 Take 扩展 方法 中 topNumber 指示 的 股票 数量 。 
GetWorstPerformers 返回 一 个 IEnumerabLe<Stock>， 包 含 三 支 表 现 最 差 的 股票 。 既 然 它 们 
没有 赚 到 钱 ， 你 应 该 兑现 并 卖 出 它们 。 对 你 来 说 ， 卖 出 股票 只 是 简单 地 在 SteckPortfolio 
中 从 股票 列表 中 删除 它们 。 要 实现 这 一 点 ， 可 使 用 另 一 个 函数 对 象 来 侦 历 提 交 给 
Sellstocks 函数 的 股票 列表 (这 里 是 指 表现 最 差 的 股票 列表 )， 然 后 从 StockPortfolio 类 
维护 的 内 部 列表 中 删除 该 股票 。 


public void SellStocks(IEnumerable<Stock> stocks) 
{ 

















foreach(Stock s in stocks) 
_stocks.Remove(s); 


1.47.3 iit 

FART SA LARA AES: 生成 器 (不 带 参 数 的 函数 )、 一 元 函数 ( 带 一 个 参数 的 函 
数 ) 和 二 元 函数 〈 带 两 个 参数 的 国 数 )。 如 果 国 数 对 象 恰好 返回 一 个 布尔 值 ， 那 么 它 就 有 
一 个 更 为 特定 的 命名 约定 : 返回 布尔 值 的 一 元 函数 称 为 谓词 ， 返回 布尔 值 的 二 元 函数 称 为 
二 元 谓词 。 在 Framework 中 包含 了 Predicate<T> 和 BinaryPredicate<T> 的 定义 以 便于 应 用 
这 些 国 数 对 象 。 

List<T> 和 System.Array 类 接受 谓词 (Predicatec<T>, BinaryPredicate<T>), z) fF 
(Action<T>)、 比 较 (Comparison<T>) 和 转换 (Converter<T,U>)。 这 人 允许 以 比 之 前 更 通用 
的 方式 来 操作 这 些 集 合 。 

最 初 以 函数 对 象 的 方式 来 思考 会 有 一 些 挑战 ， 但 是 一 旦 花 点 时 间 研 究 它 ， 就 会 开始 看 到 它 
带 来 的 强大 可 能 性 。 任 何 能 够 编写 一 次 、 调 试 一 次 ， 然 后 多 次 使 用 的 代码 都 是 有 价值 的 ， 
国 数 对 象 能 帮助 你 达到 这 一 点 。 

上 述 示例 的 输出 如 下 所 示 。 


Starting Portfolio 
(0U81) lost 10.5% 




















E 
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(C#6VR) gained 2% 
(PCKD) gained 12.3% 
(BTML) gained 0.5% 
(NOVB) lost 35.2% 
(MGDCD) gained 15.7% 
(GNRCS) gained 4% 
(FNCTR) gained 9.16% 
(LMBDA) gained 9.12% 
(PCLS) gained 6.11% 
Selling the worst performers: 
(NOVB) lost 35.2% 
(0U81) lost 10.5% 
(BTML) gained 0.5% 
After Selling Worst 3 Performers 

(C#6VR) gained 2% 
(PCKD) gained 12.3% 
(MGDCD) gained 15.7% 
(GNRCS) gained 4% 
(FNCTR) gained 9.16% 
(LMBDA) gained 9.12% 
(PCLS) gained 6.11% 


1.17.4 参考 


MSDN 文档 中 的 “System.CoLLections.Generic.List<T> 
“System.Array” 主 题 。 


1.48 控制 结构 类 型 字段 初始 化 


1.18.1 问题 

你 需要 能 够 控制 结构 的 初始 化 ， 取 决 于 是 否 想 要 将 结构 的 所 有 内 部 字段 初始 化 为 基于 字段 
类 型 的 标准 默认 值 (An, int 初始 化 为 0，string 初始 化 为 空 字符 串 ) ， 或 者 初始 化 为 一 
组 非 标 准 的 默认 值 ， 或 者 初始 化 为 一 组 预定 义 的 值 。 


1.18.2 ”解决 方案 

可 以 使 用 结构 的 各 种 构造 函数 来 实现 我 们 的 目标 。 要 将 结构 的 所 有 内 部 字段 初始 化 为 基于 
字段 类 型 的 标准 默认 值 ， 只 需 使 用 结构 的 默认 初始 化 即 可 ， 稍 后 会 演示 这 一 点 。 要 将 结构 
的 字段 初始 化 为 一 组 预定 义 的 值 ， 可 以 使 用 重 载 的 构造 国 数 。 最 后 ， 要 将 结构 初始 化 为 一 
组 非 标准 的 默认 值 ， 需 要 在 结构 构造 国 数 中 使 用 可 选 参数 。 通 过 可 选 参数 ， 结 果 能 够 将 其 
内 部 字段 设置 为 构造 国 数 参 数列 表 中 可 选 参 数 指定 的 默认 值 。 
例 1-8 中 的 数据 结构 使 用 了 重 裁 的 构造 函数 初始 化 结构 的 所 有 字段 。 
例 1-8: 带 有 重 载 构造 函数 的 结构 


public struct Data 


» 6 
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public 


{ 


Data(int intData, float floatData, string strData, 
char charData, bool boolData) 


IntData = intData; 
FloatData = floatData; 
StrData = strData; 
CharData = charData; 
BoolData = boolData; 


} 


public 
public 
public 
public 
public 


public 


} 


int IntData { get; } 
float FloatData { get; } 
string StrData { get; } 
char CharData { get; } 
bool BoolData { get; } 


override string ToString()=> IntData + " :: " + FloatData +" :: "+ 
StrData + " :: " + CharData + " :: " + BoolData; 











这 是 初始 化 结构 字段 值 的 典型 方式 。 同 时 要 注意 ， 存 在 一 个 隐 式 的 默认 构造 函数 允许 结 
构 将 其 字段 初始 化 为 字段 的 默认 值 。 不 过 ， 你 也 许 想 要 将 每 个 字段 初始 化 为 非 默 认 值 。 
例 1-9 中 的 数据 结构 使 用 重 载 的 、 带 有 可 选 参数 的 构造 函数 ， 将 结构 的 所 有 字段 初始 化 








为 非 默认 值 。 














例 1-9: 带 有 包含 可 选 参数 的 构造 函数 的 结构 


public struct Data 


{ 
public 


{ 


Data(int intData, float floatData = 1.1f, string strData = "a", 
char charData = 'a', bool boolData = true) : this() 


IntData = intData; 
FloatData = floatData; 
StrData = strData; 
CharData = charData; 
BoolData = boolData; 


} 


public 
public 
public 
public 
public 


public 


} 





例 1-10 所 示 。 


int IntData { get; } 
float FloatData { get; } 
string StrData { get; } 
char CharData { get; } 
bool BoolData { get; } 


override string ToString()=> IntData + " :: " + FloatData +" :: "+ 
StrData + " :: " + CharData + " :: " + BoolData; 





当然 ， 可 以 引入 一 个 新 的 初始 化 方法 来 使 得 事情 更 为 简单 。 但 是 你 需要 显 式 调 用 它 ， 如 








例 1-10: 带 有 显 式 初 始 化 方法 的 结构 


public struct Data 


{ 
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public void Init() 


{ 
IntData = 2; 
FloatData = 1.1f; 
StrData = "AA"; 
CharData = 'A'; 
BoolData = true; 
} 


public int IntData { get; private set; } 
public float FloatData { get; private set; } 
public string StrData { get; private set; } 
public char CharData { get; private set; } 
public bool BoolData { get; private set; } 


public override string ToString()=> IntData + " :: " + FloatData +" :: "+ 
StrData + " :: " + CharData + " :: " + BoolData; 


j 


注意 ， 当 使 用 类 似 Init 这 样 的 显 式 初始 化 方法 时 ， 需 要 为 每 个 属性 添加 私有 的 属性 
setter 来 将 每 个 字段 初始 化 。 


1.18.3 讨论 
我 们 能 够 以 不 同 的 技巧 创建 例 1-8 所 示 结 构 的 实例 。 每 种 技巧 都 使 用 了 初始 化 此 结构 对 象 
的 不 同方 法 。 第 一 种 技巧 使 用 了 default 关键 字 来 创建 这 个 结构 ， 代 码 如 下 所 示 。 

Data dat = default(Data); 
default 关键 字 只 是 创建 了 这 个 结构 的 一 个 实例 ， 并 将 它 的 所 有 字段 初始 化 为 字段 的 默 
认 值 。 本 质 上 ， 所 有 的 数值 类 型 默认 为 6，bool 类 型 默认 为 false，char 默认 为 \9 '， 
string 和 其 他 引用 类 型 默认 为 null。 
现在 ， 如 果 你 并 不 介意 引用 类 型 和 char 设置 为 null 值 ， 那 就 太 好 了 ; 但 是 假设 你 需要 在 
创建 结构 时 将 这 些 类 型 设置 为 除 null 之 外 的 值 呢 ? 第 二 种 技巧 正 是 用 于 解决 这 个 问题 的 ; 
它 使 用 默认 无 参 构 造 函 数 ， 代 码 如 下 所 示 。 

Data dat = new Data(); 
这 一 代码 使 得 默认 无 参 构造 国 数 被 调用 。 要 附带 说 明 的 是 ， 在 使 用 结构 的 默认 无 参 构造 国 
数 时 ， 必 须 使 用 new 关键 字 创建 结构 的 一 个 实例 。 如 果 没 有 new 关键 字 ， 默 认 构 造 国 数 是 
\ 会 被 调用 的 。 因 此 ， 下 面 的 代码 并 没有 调用 到 默认 无 参 构造 国 数 。 

Data[] dat = new Data[4]; 
相反 ， 这 会 用 到 该 结构 每 个 字段 的 系统 定义 默认 值 。 
有 两 种 方法 可 以 解决 这 个 问题 。 你 可 以 使 用 元 长 的 方式 创建 Data 结构 的 一 个 数组 ， 代 码 为 : 


Data[] dat = new Data[4]; 















































dat[0] = new Data(); 
dat[1] = new Data(); 
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dat[2] 
dat[3] 


或 者 : 


ArrayList dat = new ArrayList(); 
dat.Add(new Data()); 
dat.Add(new Data()); 
dat.Add(new Data()); 
dat.Add(new Data()); 


你 也 可 以 使 用 简洁 的 选择 ， 其 中 用 到 了 LINQ. 


Data[] dataList = new Data[4]; 
dataList = (from d in dataList 
select new Data()).ToArray(); 


LINQ KIRNA Data 数组 ， 为 每 个 Data 类 型 的 结构 元 素 显 式 调 用 了 默认 无 参 构造 
函数 。 

如 果 前 两 种 选择 都 无 法 用 于 你 的 特定 案例 ， 你 总 是 可 以 创建 一 个 重 载 的 构造 函数 ， 为 每 个 
想 要 初始 化 的 字段 传 入 参数 。 第 三 种 技巧 需要 使 用 重 载 的 构造 函数 来 创建 此 结构 的 一 个 新 
实例 ， 代 码 如 下 所 示 。 


public Data(int intData, float floatData, string strData, 
char charData, bool boolData) 


new Data(); 
new Data(); 








{ 
IntData = intData; 
FloatData = floatData; 
StrData = strData; 
CharData = charData; 
BoolData = boolData; 

} 














T+ 


这 个 构造 函数 显 式 地 将 每 个 字段 初始 化 为 用 户 提 供 的 人 
Data dat = new Data(2, 2.2f, "blank", 'a', false); 
在 CH 6.0 中 ， 你 不 仅 可 以 选择 将 结构 的 字段 初始 化 为 系统 默认 值 ， 或 者 使 用 重 载 的 构造 图 


数 将 字段 初始 化 为 用 户 定义 的 值 ， 还 可 以 使 用 带 有 可 选 参数 的 重 载 构造 函数 将 字段 初始 化 
为 非 系统 的 默认 值 ， 如 例 1-9 中 所 示 。 带 有 可 选 参数 的 构造 函数 看 起 来 如 下 所 示 。 


public Data(int intData, float floatData = 1.1f, string strData = "a", 
char charData = 'a', bool boolData = true) : this() 








° 











{ 
} 


使 用 这 种 构造 函数 的 一 个 问题 是 ， 你 必须 至 少 给 这 个 构造 函数 提供 一 个 参数 值 。 如 果 
intData 参数 也 有 一 个 关联 的 可 选 参 数 : 


public Data(int intData = 2, float floatData = 1.1f, string strData = "a", 
char charData = 'a', bool boolData = true) : this() 
































( 
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} 
那么 ， 下 面 的 代码 : 
Data dat = new Data(); 
将 调用 结构 的 默认 无 参 构造 函数 ， 而 不 是 重 载 的 构造 函数 。 这 是 必须 将 至 少 一 个 参数 传 入 
这 个 构造 函数 的 原因 : 
Data dat = new Data(3); 
现在 我 们 调用 了 重 载 的 构造 函数 ， 将 其 第 一 个 参数 intData 的 值 设 为 3， 并 将 其 他 参数 设 
置 为 它们 的 可 选 值 。 
最 后 一 个 选择 是 ， 你 可 以 将 一 个 显 式 的 初始 化 方法 添加 到 结构 中 ， 用 于 将 字段 初始 化 为 非 
默认 值 。 这 一 技巧 展示 在 例 1-10 中 。 
将 Init 方法 添加 到 结构 中 后 ， 必 须 在 使 用 new 或 default 关键 字 初 始 化 结构 之 后 调用 它 。 
接着 Init 方法 将 每 个 字段 初始 化 为 非 默 认 值 。 其 他 需要 做 的 代码 修改 仅仅 是 为 结构 的 属性 
添加 私有 的 setter 方法 。 这 使 得 Init 方法 可 以 设置 内 部 字段 而 无 需 将 它们 暴露 出 来 。 
1.18.4 ”参考 
MSDN 文档 中 的 “结构 ”主题 。 


1.19 ”以 更 简洁 的 方式 检查 null 值 


1.19.1 问题 


你 不 断 地 编写 笨拙 的 if-then 语句 来 判断 一 个 对 象 是 否 为 nutL。 你 需要 一 种 更 简洁 、 更 简 
单 的 方式 来 编写 这 类 代码 。 


1.19.2 ”解决 方案 


使 用 C# 6.0 中 新 引入 的 null 条 件 运算 符 。 在 过 去 ， 通 常 需要 在 使 用 对 象 前 进行 检查 以 确 
保 对 象 不 为 null。 
if (val != null) 




































































val.Trim().ToUpper(); 
a 
现在 你 可 以 简单 地 使 用 nul 条 件 运算 符 。 
val?.Trim().ToUpper(); 


这 一 简化 的 语法 判断 val 是 否 为 nuLL; 如 果 是 ， 那 么 将 不 会 调用 Trim 和 ToUpper 方法 ， 
也 就 不 会 引发 讨厌 的 NullReferenceException, ani val A fe nutL， 则 将 调用 Trim 和 
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ToUpper 方法 。 
在 使 用 点 运算 符 将 一 系列 对 象 成 员 访问 链 到 一 起 时 ， 也 可 以 使 用 nutLt 条 件 运算 符 测 试 每 个 
HRA 7j null, 
Person?.Address?.State?.Trim(); 
在 这 种 情况 下 ， 如 果 前 面 三 个 对 象 (Person、Address 和 State) 中 任何 一 个 为 nuLL， 点 运 
算 符 将 不 再 对 null 对 象 进 行 调用 ， 此 表达 式 的 执行 也 会 终止 。 
null 条 件 运 算 符 不 仅 可 以 用 于 常规 对 象 ， 也 可 以 用 于 数组 和 索引 以 及 返回 的 索引 元 素 。 例 
如 ， 如 果 val 的 类 型 是 string[] ， 这 行 代码 将 检查 val 变量 的 值 是 否 为 null。 
val?[0].ToUpper(); 
然而 下 面 这 行 代码 检查 保存 在 val 数组 中 0 索引 位 置 上 的 实际 string 元 素 是 否 为 null, 
val[0]?.ToUpper(); 
下 面 这 一 行 代码 也 是 有 效 的 ， 它 同时 检查 val 和 8 索引 的 元 素 是 否 为 null。 
val?[0]?.ToUpper(); 
null 条 件 运算 符 表现 突出 的 另外 一 个 领域 是 调用 委托 和 事件 。 例 如 ， 如 果 你 有 一 个 简单 的 
委托 : 
public delegate bool Approval(); 
并 且 使 用 lambda 表达 化 实例 化 它 ， 为 了 简化 而 直接 返回 true: 
Approval approvalDelegate = () => { return true; }; 
之 后 当 你 想 调 用 这 一 委托 时 ， 就 不 需要 编写 任何 笨重 的 条 件 代码 去 判断 委托 是 否 为 nuLtL; 
只 要 简单 地 使 用 null 条 件 运算 符 即 可 。 


approvalDelegate?. Invoke( ) 
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1.19.3 讨论 

AML, null 条 件 运算 符 以 类 似 于 三 元 运算 符 (?:) 的 方式 工作 。 以 下 代码 : 
val?.Trim(); 

是 以 下 代码 的 简写 : 
(val != null ) ? (string)val.Trim() : null 

上 述 代码 假设 val 的 类 型 是 string, 

让 我 们 来 看 一 下 如 果 返 回 的 是 值 类 型 会 发 生 什 么 ， 代 码 如 下 所 示 。 
val?.Length; 


上 述 表 达 式 被 修改 为 返回 一 个 可 空 的 值 类 型 ， 例 如 int? , 
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(val != null ) ? (int?)val.Length : null 
这 意味 着 你 不 能 简单 地 使 用 nutL 运算 符 并 将 返回 值 赋 给 任意 类 型 ， 它 必须 是 一 个 可 空 类 
型 。 因 此 ， 下 面 这 行 代码 是 无 法 编译 的 。 

int len = val?.Length; 
但 是 下 面 这 行 代码 可 以 编译 。 

int? len = val?.Length; 
注意 ， 仅 在 值 类 型 的 情况 下 才 需 要 将 返回 类 型 变 成 可 空 类 型 。 
此 外 ， 你 不 能 在 期 望 一 个 非 空 类 型 的 地 方 尝试 使 用 null 条 件 运 算 符 。 例 如 ， 数 组 的 大 小 期 
望 一 个 int 值 ， 所 以 你 不 能 编译 下 面 这 行 代码 。 

byte[] data = new byte[val?.Length]; 


Aik, PRAT LE GetValueOrDefault 方法 将 可 空 类 型 的 值 转化 为 非 空 类 型 友好 的 值 ， 代 
码 如 下 所 示 。 


byte[] data = new byte[(val?.Length).GetValueOrDefault()]; 


这 一 方式 下 ， 如 果 val Jj null, byte 数组 将 被 初始 化 为 整数 类 型 的 默认 值 ， 也 就 是 0。 注 
意 这 一 方法 会 返回 值 类 型 的 默认 值 ， 对 于 数值 类 型 为 6， 对 于 bool 类 型 为 false。 你 的 代 
码 必须 考虑 到 这 一 点 ， 以 保证 应 用 程序 行为 的 一 致 性 。 在 这 个 例子 中 ， 当 va 对 象 的 长 度 
为 8 或 者 val A null tbl, byte 数组 的 大 小 为 0， 因此 你 的 应 用 程序 逻辑 必须 处 理 这 一 点 。 


需要 在 条 件 语句 中 使 用 这 一 运算 符 时 也 要 小 心 。 


if (val?.Length > 0) 
Console.WriteLine("val.length > 0"); 

else 
Console.WriteLine("val.length = 0 or null"); 


在 这 个 条 件 语句 中 ， 如 果 val 变量 不 为 null 并 且 长 度 大 于 0, if 语句 的 真 值 语 句 块 将 会 执 
行 并 显示 文本 "val.length > 9"。 如 果 val 为 nutL， 假 值 语句 块 将 执行 并 显示 文本 "val， 
length = 0 or nuLL"。 然 而 ， 你 并 不 知道 val 究竟 是 什么 : 是 null 还 是 6 呢 ? 


如 果 需 要 检查 val 的 长 度 是 否 为 0， 可 以 在 if-else 语句 中 添加 额外 的 检查 ， 以 考虑 所 有 
情况 。 


if (val?.Length > 0) 
Console.WriteLine("val.Length > 0"); 
else if (val?.Length -- 0) 
Console.WriteLine("val.Length = 0"); 
else 
Console.WriteLine("val.Length = null"); 


switch 语句 以 如 下 相似 的 方式 运行 。 


switch (val?.Length) 


{ 


case 0: 
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Console.WriteLine("val.Length = 0"); 
break; 
case 1: 
Console.WriteLine("val.Length = 1"); 
break; 
default: 
Console.WriteLine("val.Length > 1 or val.Length = null"); 
break; 


} 


如 果 val 为 nuLL， 将 跳 转 到 default 语句 块 执行 。 除 非 进 行 更 多 的 检查 ， 你 无 法 知道 val 
的 长 度 是 大 于 1 还 是 null, 





在 条 件 语句 中 使 用 null 条 件 运 算 符 时 要 小 心 。 如 果 不 够 小 心 ， 这 一 用 法 可 能 
导致 代码 中 的 逻辑 错误 。 





1.19.4 参考 


MSDN 文档 中 的 “NuLL 条 件 运 算 符 ”主题 。 
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第 2 章 





集合 、 人 改 举 器 和 迭代 器 


2.0 简介 


集合 是 一 组 数据 项 , 在 .NET 中 ， 集 合 包含 对 象 ， 而 包含 在 集合 中 的 每 个 对 象 被 称 为 元 素 
(element), 。 有 些 集合 包含 简单 的 元 素 列 表 ， 而 另外 一 些 集合 [比如 字典 (dictionary)] WI 
包含 键 值 对 的 列表 。 下 列 集 合 类 型 包含 简单 的 元 素 列 表 。 


System.Collections.ArrayList 
System.Collections.BitArray 
System.Collections.Queue 
System.Collections. Stack 
System.Collections.Generic.LinkedList<T> 
System.Collections.Generic.List<T> 
System.Collections.Generic.Queue<T> 
System.Collections.Generic. Stack<T> 
System.Collections.Generic.HashSet<T> 


下 列 集合 类 型 都 是 字典 。 


System.Collections.Hashtable 
System.Collections.SortedList 
System.Collections.Generic.Dictionary«T,U» 
System.Collections.Generic.SortedList<T ,U> 


最 后 一 种 集合 类 型 (HashSet<T>) 可 被 视 为 无 重复 的 元 素 列表 。 


System.Collections.Generic.HashSet<T> 











这 些 集合 类 都 组 织 在 System.Collections 和 System.Collections.Generic 命名 空间 下 。 
除了 这 些 命 名 空间 之 外 ， 另 一 个 名 为 System.Collections.Specialized 的 命名 空间 中 还 包 





含 另外 几 个 有 用 的 集合 类 。 这 些 类 不 像 上 述 那些 类 那样 为 人 熟知 ， 下 面 给 出 了 它们 的 简要 
解释 。 














ListDictionary 

该 类 的 操作 方式 类 似 于 Hashtable。 不 过 ， 当 包含 10 个 或 10 个 以 下 的 元 素 时 ， 该 类 的 
性 能 要 优 于 Hashtable, 

HybridDictionary 

该 类 包含 两 个 内 部 集合 : ListDictionary 和 Hashtable。 在 任 一 时 刻 只 会 使 用 其 中 一 个 
类 。 当 集合 中 包含 10 个 或 10 个 以 下 的 元 素 时 ， 将 使 用 Listpictionary， 而 当 集 合 中 包 
含 的 元 素 增长 到 10 个 以 上 时 ， 就 切换 到 使 用 Hashtable。 这 种 切换 对 于 开发 人 员 古 透明 
的 。 一 旦 使 用 Hashtable， 该 集合 就 不 能 回复 到 使 用 Listpictionary， 即 使 元 素 个 数 降 
到 10 个 以 下 时 也 是 如 此 。 另 外 要 注意 ， 当 使 用 字符 串 作 为 键 时 ， 该 类 通过 在 构造 函数 
中 设置 一 个 布尔 值 ， 可 以 同时 支持 区 分 大 小 写 (考虑 到 固定 区 域 性 ) 和 不 区 分 大 小 写 的 
字符 串 查 找 。 

CollectionsUtil 

该 类 包含 两 个 静态 方法 : 一 个 用 于 创建 不 区 分 大 小 写 的 Hashtable， 另 一 个 用 于 创建 不 
区 分 大 小 写 的 SortedList。 在 直接 创建 Hashtable 和 SortedList 对 象 时 ， 总 会 创建 区 分 


大 小 写 的 Hashtable 或 SortedList， 除 非 你 使 用 某 个 接受 IComparer 参数 的 构造 函数 ， 
并 将 CaseInsensitiveComparer .Default 传递 给 它 。 









































NameValueCollection 

这 个 集合 包含 键 值 对 ， 其 中 键 和 值 都 是 String 类 型 。 关 于 这 个 集合 ， 有 一 件 有 趣 的 事 
情 是 ， 它 可 以 用 一 个 键 存储 多 个 字符 串 值 。 多 个 字符 串 之 间 用 逗号 隔 开 。 在 隔 开 一 个 值 
中 的 多 个 字符 串 时 ， 可 以 使 用 String.Split 方法 。 

StringCollection 

这 个 集合 是 包含 字符 串 元 素 的 简单 列表 。 该 列表 接受 null 元 素 以 及 重复 的 字符 串 。 该 
列表 区 分 大 小 写 。 

StringDictionary 

这 是 一 个 Hashtable， 它 将 键 和 值 存储 为 字符 串 。 在 把 键 添加 到 Hashtable 中 之 前 ， 将 
它们 全 部 转换 成 小 写字 母 ， 从 而 允许 进行 不 区 分 大 小 写 的 比较 。 键 不 能 为 nutL， 但 是 
值 可 以 设置 成 null。 












































CH 编译 器 还 支持 固定 大 小 的 数组 。 可 以 使 用 以 下 语法 创建 任意 类 型 的 数组 。 








int[] foo = new int[2]; 
T[] bar = new T[2]; 











这 里 ，foo 是 一 个 整 型 数组 ， 甚 中 正好 包含 两 个 元 素 ，bar 是 未 知 类 型 T 的 一 个 数组 。 


数组 也 可 以 具有 多 种 样式 ， 比 如 单 维 数组 、 锯 齿 形 数组 ， 其 至 锯齿 形 多 维 数 组 。 多 维 数 组 
的 定义 如 下 所 示 。 








集合 、 枚 举 器 和 人 迭代 器 | 73 


int[,] foo = new int[2,3]; // 一 个 包含 6 个 元 素 的 二 维 数组 





int[,,] bar = new int[2,3,4]; // 一 个 包含 24 个 元 素 的 三 维 数组 


通常 将 二 维 数 组 描述 为 具有 行 和 列 的 表 。foo 数组 可 被 描述 为 一 个 包括 两 行 的 表 ， 其 中 每 
一 行 包含 三 个 元 素 列 。 三 维 数组 可 以 被 描述 为 一 个 有 多 层 表 的 立方 体 。bar 数组 可 以 被 措 
述 为 4 层 ， 每 一 层 包含 两 行 ， 每 一 行 包含 三 个 元 素 列 。 

锯齿 形 数组 是 数组 的 数组 。 如 果 把 锯齿 形 数组 描述 成 一 个 一 维 数组 ， 该 数组 中 的 每 个 元 素 
包含 男 一 个 一 维 数组 ， 那 么 每 一 行 中 就 可 以 具有 不 同 的 元 素 个 数 。 锯 此 形 数组 的 定义 如 下 
所 示 。 


int[][] baz = new int[2][] {new int[2], new int[3]}; 


baz 数组 包含 一 个 一 维 数组 ， 该 数组 包含 两 个 元 素 。 其 中 每 个 元 素 都 包含 另 一 个 数组 ， 第 
一 个 数组 具有 两 个 元 素 ， 第 二 个 数组 具有 三 个 元 素 。 

在 使 用 集合 时 ， 某 些 时 候 你 可 能 需要 检查 集合 中 的 所 有 值 。 为 了 帮助 你 做 到 这 一 点 ，C# 
HEE T KARAS PK AE, GAAS (iterator) 允许 代码 块 产生 有 序 的 值 ， 而 枚 举 器 
(enumerator) 支持 运 代 数据 集 ， 并 且 可 以 用 于 读 取 集 合 中 的 数据 ， 但 是 不 能 修改 它 。 


迭代 器 是 一 种 机 制 ， 用 于 产生 可 以 被 foreach 循环 构造 遍历 的 数据 。 不 过 ， 迭 代 器 要 比 这 
灵活 得 多 。 你 可 以 轻松 生成 由 枚 举 器 返回 的 数据 序列 [ 称 为 迟缓 计算 (lazy computation) ] , 
而 不 必 预 先进 行 硬 编码 [如 同 积极 计算 (eager computation) 中 所 做 的 ] 。 例 如 ， 你 可 以 根 
据 需 要 轻松 地 编写 一 个 生成 斐 波 那 契 数 列 的 枚 举 器 。 迭 代 器 的 另 一 个 灵活 的 特性 是 ， 不 必 
对 迭代 器 返回 的 值 的 个 数 设置 限制 。 因 此 在 本 示例 中 ， 可 以 选择 何 时 停止 产生 斐 波 那 契 数 
列 。 这 是 LINQ 世界 中 一 个 有 趣 的 特点 。IEnumerable 的 where 查询 生成 的 迭代 器 是 迟缓 
的 ， 而 分 组 或 排序 需要 积极 计算 。 

迭代 器 允许 你 把 编写 这 个 类 的 工作 移交 给 CH 编译 器 。 现 在 ， 你 只 需 把 迭代 器 添加 到 类 型 
中 。 迭 代 器 是 类 型 中 的 一 个 成 员 〈 例 如 ， 方 法 、 运 算 符 重 载 或 属性 的 get 访问 器 ) ， 该 成 员 


返回 一 个 System.Collections.IEnumerator, System.Collections.Generic.IEnumerator«T», 






















































































System.Collections.IEnumerable 或 System.CoLLections.Generic.IEnumerator<T>， 并 且 包 
含 至 少 一 个 yield 语句 。 这 人 允许 你 编写 可 以 被 foreach 循环 使 用 的 类 型 。 


E AE A E LINQ 中 起 着 重要 的 作用 ， 因 为 LINQ to Object 基于 能 够 操作 那些 实现 了 
TEnumerable<T> 的 类 。 和 迭代 器 允许 查询 引擎 在 志 历 集合 时 执行 多 种 不 同 的 查询 、 投 影 、 排 
序 和 分 组 操作 。 如 果 没 有 和 迭代 器 的 支持 ，LINQ 将 变 得 极其 麻烦 ， 并 且 它 引入 的 声明 性 编 
程 风格 将 变 得 很 笨拙 ， 甚 至 完全 失去 这 种 能 


2.1 寻找 List<T> 中 的 重复 数据 项 


2.1.1 问题 
你 需要 能 够 对 一 个 List<T> 中 匹配 搜索 条 件 的 对 象 进行 读 取 或 计数 操作 。 





























2.1.2 解决 方案 


使 用 List<T> 的 四 个 扩展 方法 : GetAll, BinarySearchGetAll, CountAll 和 | BinarySearchCountAll, 
这 些 方法 扩展 List<T> 类 ， 以 返回 特定 的 对 象 实例 或 特定 对 象 出 现在 有 序 和 无 序 List<T> 中 的 次 
数 ， 如 例 2-1 所 示 。 

例 2-1: 确定 一 个 数据 项 在 List<T> 中 出 现 的 次 数 


static class CollectionExtMethods 


{ 











region 2.1 寻找 List<T> 中 的 重复 数据 项 








// 从 一 个 有 序 或 无 序 的 List<T> 中 获取 所 有 匹配 对 象 的 方法 
public static IEnumerabLe<T> GetAll<T>(this List<T> myList, T searchValue) => 


myList.Where(t => t.Equals(searchValue)); 


// 从 一 个 有 序 的 List<T> 中 获取 所 有 匹配 对 象 的 方法 
public static T[] BinarySearchGetAll<T>(this List<T> myList, T searchValue) 


{ 


List<T> retObjs = new List<T>(); 


// 查找 第 一 个 元 素 
int center = myList.BinarySearch(searchValue); 
if (center > 0) 
{ 
retObjs.Add(myList[center ]); 


int left = center; 
while (left > 0 && myList[left - 1].Equals(searchValue)) 
{ 
left -= 1; 
retObjs.Add(myList[left]); 
} 


int right = center; 
while (right < (myList.Count - 1) && 
myList[right + 1].Equals(searchValue)) 


{ 
right += 1; 
retObjs.Add(myList[right]); 


j 


return (retObjs.ToArray()); 


} 

// 统计 一 个 数据 项 在 无 序 或 有 序 的 List<T> 中 出 现 的 次 数 

public static int CountALL<T>(this List<T> myList, T searchValue) => 
myList.GetAll(searchValue).Count(); 














// 统计 一 个 数据 项 在 有 序 的 List<T> 中 出 现 的 次 数 

public static int BinarySearchCountAll<T>(this List<T> myList, T searchValue) => 
BinarySearchGetAll(myList, searchValue).Count(); 

#endregion // 2.1 
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2.1.3 讨论 
GetALL 和 BinarySearchGetAll 方法 返回 在 List<T> 对 象 中 找到 的 实际 数据 项 。CountALL 和 
BinarySearchCountAll 方法 利用 GetALL 和 BinarySearchGetAll 以 提供 数据 项 的 计数 。 在 
GetALL 和 BinarySearchGetAll 之 间 进 行 选 择 时 要 牢记 的 主要 事情 是 : 将 要 查找 的 List<T> 
是 否 为 有 序 的 。 选 择 GetALL 和 CountALL 方法 从 无 序 的 List<T> 中 获取 所 有 查找 到 的 数据 
项 的 数组 (GetAll) 或 者 查找 到 数据 项 的 数量 〈CountALL) ， 对 于 有 序 的 List<T> 则 选择 
BinarySearchAll 和 BinarySearchCountALL。GetALL、SearchALL 和 BinarySearchAll 使 用 了 
表达 式 - 函数 体 成 员 语 法 ， 因 为 它们 是 简单 函数 。 
下 面 的 代码 使 用 了 List<T> 类 的 这 两 个 新 的 扩展 方法 。 

// 获取 


List<int> listRetrieval = 
new List<int>() { -1, -1, 1, 2, 2, 2, 2, 3, 100, 4, 5 }; 




















Console.WriteLine("--GET All--"); 

IEnumerable<int> items = listRetrieval.GetAll(2); 

foreach (var item in items) 
Console.WriteLine($"item: {item}"); 


Console.WriteLine(); 

items = listRetrieval.GetAll(-2); 

foreach (var item in items) 
Console.WriteLine($"item-2: {item}"); 


Console.WriteLine(); 

items = listRetrieval.GetAll(5); 

foreach (var item in items) 
Console.WriteLine($"item5: {item}"); 


Console.WriteLine('"\r\n--BINARY SEARCH GET ALL--"); 

listRetrieval.Sort(); 

int[] listItems = listRetrieval.BinarySearchGetAll(-2); 

foreach (var item in listItems) 
Console.WriteLine($"item-2: {item}"); 


Console.WriteLine(); 

listItems = listRetrieval.BinarySearchGetAll(2); 

foreach (var item in listItems) 
Console.WriteLine($"item2: {item}"); 


Console.WriteLine(); 

listItems = listRetrieval.BinarySearchGetAll(5); 

foreach (var item in listItems) 
Console.WriteLine($"item5: {item}"); 


这 段 代 码 的 输出 如 下 所 示 。 


--GET All-- 
item: 2 
item: 2 
item: 2 








Bi 
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Li 


item: 2 


item5: 5 


--BINARY SEARCH GET ALL-- 


item2: 
item2: 
item2: 
item2: 


NJ NON PN 


item5: 5 


narySearchGetAll 方法 比 o s 快 ， 尤 其 是 当 数 组 已 排 好 序 时 。 如 果 对 无 序 
List<T> 使 用 BinarySearch， 那 么 查找 返回 的 结果 将 会 是 错误 的 ， 因 为 文档 中 一 直 将 
st<T> 有 序 作为 它 的 前 提 nun 
































T 


CountAll 方法 接受 一 个 泛 型 类 型 T 的 查找 值 (searchValue)。 然 后 ， 该 方法 继续 统计 这 个 


查 
的 
用 


Li 





多 。 


下 





查找 值 在 List<T> 类 中 的 出 现 次 数 ， 通 过 使 用 GetALL inu 租 数 据 项 然后 调用 结果 上 





Count, EW List<T> 是 否 有 序 ， 都 可 以 使 用 该 方法 。 如 果 List<T> 是 有 序 的 (通过 调 
Sort 方法 对 List<T> 排序 ) ， 就 可 以 使 用 PinaryssarehCoRnEA VL 方法 提高 查找 效率 。 对 
st<T> 类 利用 BinarySearchGetAll 扩展 方法 来 执行 该 任务 ， 这 比 遍 历 整个 List<T> 快 得 
当 List<T> 庞大 时 尤其 如 此 。 


看 的 代码 举例 说 明了 List<T> 类 的 两 个 新 方法 。 


List<int> list = new List<int>() {-2,-2,-1,-1,1,2,2,2,2,3,100,4,5}; 














Console.WriteLine("--CONTAINS TOTAL--"); 
int count = list.CountAll(2); 
Console.WriteLine($"Count2: {count}"); 


count = list.CountAll(3); 
Console.WriteLine($"Count3: {count}"); 


count = list.CountAll(1); 
Console.WriteLine($"Count1: {count}"); 


Console.WriteLine("\r\n--BINARY SEARCH COUNT ALL--"); 
list.Sort(); 

count = list.BinarySearchCountAll(2); 
Console.WriteLine($"Count2: {count}"); 


count = list.BinarySearchCountAll(3); 
Console.WriteLine($"Count3: {count}"); 


count = list.BinarySearchCountAll(1); 
Console.WriteLine($"Count1: {count}"); 


这 段 代 码 的 输出 如 下 所 示 。 
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--CONTAINS TOTAL- - 
Count2: 4 
Count3: 1 
Counti: 1 


--BINARY SEARCH COUNT ALL-- 
Count2: 4 
Count3: 1 
Counti: 1 


CountAllt 和 GetALL 方法 使 用 顺序 查找 ， 在 一 个 for 循环 中 执行 。 因 为 没有 假定 List<T> 
是 有 序 的 ， 所 以 必须 使 用 线性 查找 。where 语句 确定 List<T> 中 的 每 个 元 素 是 否 等 于 查找 
条 件 (searchValue)。 这 些 方法 返回 数据 项 或 数据 项 的 计数 以 指示 List<T> 中 与 查找 条 件 
匹配 的 数据 项 个 数 。 

BinarySearchGetAll 方 法 实现 了 一 个 二 又 查找 ， 用 于 定位 List<T> 中 与 查找 条 件 
(searchValue) 匹配 的 数据 项 。 如 果 找 到 这 样 一 个 数据 项 ， 就 会 使 用 一 个 while 循环 
查找 List<T> 中 第 一 个 匹配 的 数据 项 ， 并 把 该 元 素 的 位 置 记录 在 left 变量 中 。 第 二 个 
while 循环 用 于 查找 最 后 一 个 匹配 的 数据 项 ， 并 把 该 元 素 的 位 置 记录 在 right 变量 中 。 用 
right 变量 中 的 值 减 去 left 变量 中 的 值 ， 然 后 把 得 到 的 结果 加 上 1， 就 得 到 了 总 的 匹配 个 
数 。BinarySearchCountAll 使 用 BinarySearchGetAll 来 获取 数据 项 ， 然 后 仅 对 结果 和 集 调 用 
Count, 


2.1.4 参考 
MSDN 文档 中 的 “List<T> 类 ”主题 。 


2.2 保持 Ltst<T> 有 序 


2.2.1 问题 


你 将 使 用 List<T> 的 BinarySearch 方法 定期 查找 List<T> 中 的 特定 元 素 。 在 查找 过 程 中 ， 
将 穿插 进行 添加 、 修 改 和 删除 元 素 的 操作 。 不 过 ，BinarySearch 方法 预先 假设 数组 是 有 序 
HJ; AWA List<T> 是 无 序 的 ，BinarySearch 方法 可 能 返回 不 正确 的 结果 。 你 不 希望 必须 记 
住 在 调用 List<T>.BinarySearch 方法 之 前 调用 List<T>.Sort 方法 ， 更 不 必 说 会 引入 与 该 
调用 关联 的 所 有 开销 。 你 需要 采用 一 种 方法 保持 List<T> 有 序 ， 而 不 必 总 是 调用 List<T>. 
Sort 方法 。 


2.2.2 解决 方案 

下 面 的 SortedList 泛 型 类 增强 了 在 List<T> 内 添加 和 修改 元 素 的 操作 。 在 向 其 添加 数据 项 
或 修改 数据 项 时 ， 这 些 方法 可 以 保持 数组 有 序 。 注 意 ， 这 里 并 不 需要 DeleteSorted 方法 ， 
因为 删除 数据 项 不 会 干扰 剩余 数据 项 的 排序 顺序 。 


public class SortedList<T> : List<T> 


{ 
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public new void Add(T item) 


{ 
int position = this.BinarySearch(item); 
if (position < 0) 
position = ~position; 
this.Insert(position, item); 
} 
public void ModifySorted(T item, int index) 
{ 
this .RemoveAt(index) ; 
int position = this.BinarySearch(item) ; 
if (position < 0) 
position = ~position; 
this.Insert(position, item); 
} 


2.2.3 讨论 
在 保持 List<T> 有 序 的 同时 使 用 Add 方法 添加 元 素 。Add 方法 接受 一 个 泛 型 类 型 (T) 以 添 
加 到 有 序列 表 中 。 


不 要 直接 使 用 List<T> 索引 器 修改 元 素 ， 而 是 使 用 ModifySorted 方法 修改 元 素 ， 同 时 保持 
List<T> 有 序 。 调 用 这 个 方法 ， 传 入 泛 型 类 型 T 以 禁 换 现 有 的 对 和 象 (item)， 并 且 传 人 要 修 
改 对 象 的 索引 (index), 


下 面 的 代码 演示 了 SortedList<T> 类 。 
// 创建 一 个 SortedList 并 用 随机 选择 的 数值 填充 


SortedList<int> sortedList = new SortedList<int>(); 
sortedList.Add(200); 
sortedList.Add(20); 
sortedList.Add(2); 
sortedList.Add(7); 
sortedList.Add(10); 
sortedList.Add(0); 
sortedList.Add(100); 
sortedList.Add(-20); 
sortedList.Add(56); 
sortedList.Add(55); 
sortedList.Add(57); 
sortedList.Add(200); 
sortedList.Add(-2); 
sortedList.Add(-20); 
sortedList.Add(55); 
sortedList.Add(55); 























/] 显示 列表 
foreach (var i in sortedList) 
Console.WriteLine(i); 
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// 现在 修改 一 些 索引 处 的 值 
sortedList.ModifySorted(0, 5); 
sortedList.ModifySorted(1, 10); 
sortedList.ModifySorted(2, 11); 
sortedList.ModifySorted(3, 7); 
sortedList.ModifySorted(4, 2); 
sortedList.ModifySorted(2, 4); 
sortedList.ModifySorted(15, 0); 
sortedList.ModifySorted(0, 15); 
sortedList.ModifySorted(223, 15); 


// 显示 列表 

Console.WriteLine(); 

foreach (var i in sortedList) 
Console.WriteLine(i); 


该 方法 在 保持 List<T> 排序 顺序 的 同时 自动 把 新 数据 项 置 于 其 中 ， 执 行 该 操作 时 ， 无 需 
显 式 调用 List<T>.Sort。 其 原因 是 ，Add 方法 首先 调用 BinarySearch 方法 ， 并 把 要 添加 到 
List<T> 中 的 对 象 传递 给 它 。BinarySearch 方法 将 返回 在 其 中 找到 相同 数据 项 的 索引 或 者 
返回 一 个 负数 ， 可 以 用 返回 值 来 确定 查找 的 数据 项 应 该 位 于 什么 位 置 。 如 果 BinarySearch 
方法 返回 一 个 正 数 ， 就 可 以 使 用 List<T>.Insert 方法 在 那个 位 置 插入 一 个 新 元 素 ， 保 持 
List<T> 内 的 排序 顺序 。 如 果 BinarySearch 方法 返回 一 个 负数 ， 就 可 以 使 用 按 位 求 补 运算 
符 ~ 来 确定 数据 项 应 该 位 于 什么 位 置 ， 假 定 它 存在 于 一 个 有 序列 表 中 。 使 用 这 个 数字 ， 可 
以 使 用 List<T>. Insert 方法 把 数据 项 添加 到 有 序列 表 中 的 正确 位 置 ， 同 时 保持 正确 的 排序 
顺序 。 


可 以 在 不 于 扰 排 序 顺序 的 情况 下 从 有 序列 表 中 删除 元 素 ， 但 是 在 List<T> 中 修改 元 素 的 
值 则 极 有 可 能 导致 有 序列 表 变 得 无 序 。ModifySorted 方法 缓解 了 这 个 问题 。 该 方法 的 工 
作 方 式 类 似 于 Add 方法 ， 只 不 过 它 首 先 从 List<T> 中 删除 元 素 ， 然 后 把 新 元 素 插 入 正确 
的 位 置 。 

2.2.4 参考 

MSDN 文档 中 的 “List<T> 类 ”主题 。 


2.3 ”对 Dictionary 的 键 和 /或 值 排序 


2.3.1 问题 

你 想 要 对 一 个 Dictionary 中 包含 的 键 和 /或 值 排序 ， 以 便 把 整个 Dictionary 显示 给 用 户 ， 
并 以 升序 或 降序 方式 对 它 进 行 排序 。 

23.2 解决 方案 


通过 LINQ 查询 以 及 Dictionary«T ,U» 对 象 的 Keys 和 Values 属性 ， 获 得 其 键 和 值 对 象 的 有 
序 ICollection。 下面 所 示 的 代码 显示 以 升序 或 降序 排序 的 Dictionary<T,U> 的 键 和 值 。 
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// 定义 一 个 Dictionary<T,U> 对 象 
Dictionary<string, string> hash = new Dictionary<string, string>() 


{ 
["2"] = "two", 
["1"] = "one", 
["5"] = "five", 
["4"] = "four", 
["3"] = "three" 
J; 


var x = from k in hash.Keys orderby k ascending select k; 
foreach (string s in x) 
Console.WriteLine($"Key: {s} Value: {hash[s]}"); 


x = from k in hash.Keys orderby k descending select k; 
foreach (string s in x) 
Console.WriteLine($"Key: {s} Value: {hash[s]}"); 


下 面 的 代码 显示 以 升序 或 降序 排序 的 Dictionary<T,U> 中 的 值 。 


= from k in hash.Values orderby k ascending select k; 
foreach (string s in x) 
Console.WriteLine($"Value: {s}"); 

















Console.WriteLine(); 


= from k in hash.Values orderby k descending select k; 
foreach (string s in x) 
Console.WriteLine($"Value: {s}"); 


2.3.3 讨论 


Dictionary«T,U» 对 象 公 开 了 两 个 有 用 的 属性 ， 用 于 获得 其 键 或 值 的 集合 。Keys 属性 返回 
一 个 ICoLLection， 其 中 包含 目前 在 Dictionary<T,U> 中 的 所 有 键 。Values 属性 也 返回 一 个 
ICollection， 其 中 包含 目前 在 Dictionary<T,U> 中 的 所 有 值 。 


通 过 Dictionary<T,U> 对 象 的 Keys 或 Values 属 性 返回 的 ICollection 对 象 包含 对 
Dictionary<T,U> 内 的 键 和 值 集体 的 直接 引用 。 这 意味 着 如 果 Dictionary<T,U> 中 的 键 和 / 
或 值 发 生变 化 ， 键 和 值 集合 也 将 相应 地 改变 


意 ， 你 还 可 以 使 用 SortedDictionary<T,U> 类 ， 该 类 自动 将 键 保持 为 有 序 。 还 可 以 使 用 
Sau aie U> HS Aa PRI CE ARE BELG Dictionary<T,U>, ee 属性 默认 按 
升序 排序 ， 因 此 如 果 想 要 按 降 序 排 序 ， 将 需要 基于 Keys 以 降序 方式 对 集合 进行 排序 。 


SortedDictionary<string, string> sortedHash = 
new SortedDictionary<string, string>() 















































{ 
["2"] = "two", 
["1"] = "one", 
["5"] = "five", 
["4"] = "four", 
["3"] = "three" 
J; 
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foreach (string key in sortedHash.Keys) 
Console.WriteLine($"Key: {key} Value: {sortedHash[key]}"); 

foreach (string key in sortedHash.OrderByDescending(item => 
item.Key).Select(item => item.Key)) 
Console.WriteLine($"Key: {key} Value: {sortedHash[key]}"); 


为 什么 有 人 会 选择 使 用 展示 的 LINQ 方案 ， 而 非 只 是 使 用 SortedDictionary<T ,U> We? 在 
LINQ 查询 中 执行 排序 实际 上 更 快 ， 代码 也 比 使 用 SortedDictionary<T,U> 更 简洁 ， 因 此 在 
支持 LINQ 的 所 有 NET 版 本 (3.0 及 更 高 ) 中 这 是 推荐 方法 。 如 果 你 的 解决 方案 碰巧 是 旧 
版 本 的 .NET， 仍 然 可 以 使 用 SortedDictionary<T,U> 来 实现 结果 。 


2.34 ”参考 


MSDN 文档 中 的 “Dictionary<T,U> 类 ”“SortedDictionary<T,U> 类 ”和 “List<T > 类 ” 
主题 。 


2.4 ”创建 具有 最 小 值 和 最 大 值 边界 的 Dictionary 


2.4.1 问题 


你 需要 在 项 目 中 使 用 一 个 泛 型 Dictionary 对 象 ， 它 在 值 中 仅 存储 预定 义 最 大 值 和 最 小 值 之 
间 的 数值 数据 〈 键 可 以 是 任意 类 型 ) 。 


2.4.2 ”解决 方案 


创建 一 个 类 ， 它 带 有 强制 执行 这 些 边界 的 访问 器 和 方法 。 例 2-2 中 所 示 的 类 
MinMaxValueDictionary 只 人 允许 存储 实现 了 IComparable 接口 的 类 型 ， 并 且 其 值 位 于 最 大 值 
和 最 小 值 之 间 。 
例 2-2: 创建 具有 最 小 值 和 最 大 值 边 界 的 字典 

[Serializable] 


public class MinMaxValueDictionary<T, U> 
where U : IComparable<U> 



















































































{ 


protected Dictionary<T, U> internalDictionary = null; 


public MinMaxValueDictionary(U minValue, U maxValue) 


{ 
this.MinValue = minValue; 
this.MaxValue = maxValue; 
internalDictionary = new Dictionary<T, U>(); 
} 
public U MinValue { get; private set; } = default(U); 
public U MaxValue { get; private set; } = default(U); 


public int Count => (internalDictionary.Count); 


public Dictionary<T, U>.KeyCollection Keys => (internalDictionary.Keys); 
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public Dictionary<T, U>.ValueCollection Values => (internalDictionary.Values); 


public U this[T key] 


{ 
get { return (internalDictionary[key]); } 
set 
{ 
if (value.CompareTo(MinValue) >= 0 && 
value.CompareTo(MaxValue) <= 0) 
internalDictionary[key] = value; 
else 
throw new ArgumentOutOfRangeException(nameof(value), value, 
$'Value must be within the range {MinValue} to {MaxVaLlue}"); 
} 
} 
public void Add(T key, U value) 
{ 
if (value.CompareTo(MinValue) >= 0 && 
value.CompareTo(MaxValue) <= 0) 
internalDictionary.Add(key, value); 
else 
throw new ArgumentOutOfRangeException(nameof(value), value, 
$'Value must be within the range {MinValue} to (MaxValuej"); 
} 


public bool ContainsKey(T key) => (internalDictionary.ContainsKey(key) ); 
public bool ContainsValue(U value) => (internalDictionary.ContainsValue(value)); 
public override bool Equals(object obj) -» (internalDictionary.Equals(obj)); 
public IEnumerator GetEnumerator() -» (internalDictionary.GetEnumerator()); 
public override int GetHashCode() -» (internalDictionary.GetHashCode()); 
public void GetObjectData(SerializationInfo info, StreamingContext context) 


{ 


internalDictionary.GetObjectData(info, context); 


} 
public void OnDeserialization(object sender) 
{ 
internalDictionary.OnDeserialization(sender); 
} 


public override string ToString() => (internalDictionary.ToString()); 


public bool TryGetValue(T key, out U value) => 
(internalDictionary.TryGetValue(key, out value)); 


public void Remove(T key) 
{ 


internalDictionary.Remove(key) ; 
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j 


public void Clear() 
{ 


j 


internalDictionary.Clear(); 


j 


2.4.8 讨论 
MinMaxValueDictionary 类 包装 了 Dictionary<T,U> 类 ， 因 此 它 可 以 限制 允许 值 的 范 
下 的 代码 定义 了 MinMaxValueDictionary 类 的 重 载 构造 函数 。 
public MinMaxValueDictionary(U minValue, U maxValue) 
该 构造 函数 允许 设置 值 的 范围 。 它 的 参数 包括 以 下 两 个 。 
。 minValue 
可 以 作为 值 添加 到 键 值 对 中 类 型 U 的 最 小 值 。 
e maxValue 
可 以 作为 值 添加 到 键 值 对 中 类 型 U 的 最 大 值 。 
这 些 值 可 通过 MinMaxValueDictionary<T,U> 类 上 的 Minvalue 和 MaxValue 属性 获得 


重 写 的 索引 器 拥有 get 和 set 访问 器 。get 返回 与 提供 的 key 匹配 的 值 。set 检查 value 参 
数 ， 以 确定 它 是 否 在 之 前 设置 的 minValue 和 maxValue 字段 的 边界 内 。 


Add 方法 为 其 value 参数 接受 一 个 类 型 U， 并 执行 与 索引 器 上 的 set 访问 器 相同 的 测试 。 如 
果 测 试 通过 ， 就 把 整数 添加 到 MinMaxValueDictionary 中 。 

2.44 ”参考 

MSDN 文档 中 的 “Dictionary<T,U> 类 ”主题 。 


25 在 应 用 程序 会 话 间 持 久 化 一 个 集合 


2.5.1 问题 


你 有 一 个 诸如 ArrayList, List<T>, Hashtable 或 Dictionary«T,U» 这 样 的 集合 ， 在 其 中 存 
储 应 用 程序 信息 。 可 以 使 用 该 信息 将 应 用 程序 的 环境 定制 成 最 后 已 知 的 设置 〈 例 如 ， 窗 口 
大 小 、 窗 口 位 置 和 当前 显示 的 工具 栏 )。 也 可 以 用 它 来 允许 用 户 在 上 一 次 关闭 应 用 程序 的 
相同 位 置 启动 应 用 程序 。 换 名 话说 ， 如 果 用 户 正在 编辑 发 票 并 且 需 要 在 晚上 关闭 计算 机 ， 
当下 次 启动 应 用 程序 时 ， 它 将 准确 地 知道 初始 要 显示 哪 张 发 票 。 


2.5.2 ”解决 方案 


在 对 象 与 文件 之 间 进 行 序列 化 / 反 序列 化 。 
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public static void SerializeToFile<T>(T obj, string dataFile) 


{ 
using (FileStream fileStream = File.Create(dataFile) ) 
{ 
BinaryFormatter binSerializer = new BinaryFormatter(); 
binSerializer.Serialize(fileStream, obj); 
} 
} 
public static T DeserializeFromFile<T>(string dataFile) 
{ 
T obj = default(T); 
using (FileStream fileStream = File.OpenRead(dataFile)) 
{ 
BinaryFormatter binSerializer = new BinaryFormatter(); 
obj = (T)binSerializer.Deserialize(fileStream); 
} 
return obj; 
} 


2.5.3 讨论 

dataFile 参数 接受 一 个 字符 串 值 作为 文件 名 。SeriaLizeToFiLe<T> 方法 接受 一 个 对 象 并 学 
试 将 其 序列 化 到 一 个 文件 。 相 反 ，DeserializeFromFile<T> 方法 从 Save0bj<T> 方法 创建 的 
文件 中 获取 序列 化 的 对 象 。 

例 2-3 展示 了 如 何 使 用 这 些 方 法 序列 化 一 个 ArrayList 对 象 〈 注 意 ， 这 适用 于 标记 有 
SerializableAttribute 的 任何 类 型 ) 。 

例 2-3: 在 应 用 程序 会 话 间 持久 化 一 个 集合 


ArrayList HT = new ArrayList() {"Zero","One","Two"}; 








foreach (object 0 in HT) 
Console.WriteLine(0.ToString()); 
SerializeToFile<ArrayList>(HT, "HT.data"); 


ArrayList HTNew = new ArrayList(); 

HTNew = DeserializeFromFile<ArrayList>("HT.data"); 

foreach (object 0 in HTNew) 
Console.WriteLine(0.ToString()); 


如 果 在 应 用 程序 中 的 特定 时 刻 把 对 象 序 列 化 到 磁盘 ， 以 后 就 可 以 反 序 列 化 它们 并 恢复 到 一 
种 已 知 的 状态 ， 例 如 意外 关机 时 。 
你 也 可 以 在 对 象 与 字 节 流 间 进行 序列 化 / 反 序 列 化 以 存储 到 独立 存储 或 远程 存储 。 


public static byte[] Serialize<T>(T obj) 
{ 























using (MemoryStream memStream = new MemoryStream()) 

{ 
BinaryFormatter binSerializer = new BinaryFormatter(); 
binSerializer.Serialize(memStream, obj); 
return memStream.ToArray(); 
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} 
public static T Deserialize<T>(byte[] serializedObj) 
{ 
T obj = default(T); 
using (MemoryStream memStream = new MemoryStream(serializedObj)) 
{ 
BinaryFormatter binSerializer = new BinaryFormatter(); 
obj = (T)binSerializer.Deserialize(memStream); 
return obj; 
} 
如 果 你 依靠 序列 化 的 对 象 来 存储 持久 信息 ， 就 需要 清楚 在 部 署 应 用 程序 的 新 
版 本 时 将 要 做 什么 。 应 该 预先 计划 一 种 策略 ， 确 保 序列 化 的 类 型 不 会 发 生变 
化 ;或 者 预先 计划 一 种 技术 ， 用 于 处 理 所 发 生 的 变化 。 否 则 ， 在 部 署 更 新 版 
本 时 将 会 遇 到 严重 的 问题 。 查 阅 MSDN 中 的 文章 “版 本 容错 序列 化 ”以 了 
解 处 理 这 一 情况 的 理念 和 最 佳 实践 。 
2.5.4 ”参考 


MSDN 文档 中 的 “ArrayList 类 ”“Hashtable 类 ”“List<T> 类 ”“Dictionary<T,U> 2E" “File 
类 ”“ 版 本 容错 序列 化 ”和 “BinaryFormatter 类 ”主题 。 


2.6 ”测试 Array 或 List<T> 中 的 每 个 元 素 


2.6.1 问题 


你 需要 采用 一 种 容易 的 方法 来 测试 Array 或 List<T> 中 的 每 个 元 素 。 这 种 测试 的 结果 应 该 
指示 集合 中 的 所 有 元 素 都 通过 了 测试 ， 或 者 集合 中 至 少 有 一 个 元 素 没有 通过 测试 。 


2.6.2 ”解决 方案 
使 用 TrueForAtL 方法 ， 代 码 如 下 所 示 。 
// 创建 一 个 字符 串 列表 


List<string> strings = new List<string>() {"one",null,"three","four"}; 


// 确定 列表 中 是 否 包含 hul1l 值 


string str = strings.TrueForAll(delegate(string val) 


if (val == null) 
return false; 
else 
return true; 
}).ToString(); 
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// 显示 结果 
Console.WriteLine(str); 





2.6.3 讨论 

Array 和 List<T> 类 上 添加 的 TrueForAll 方法 允许 你 轻松 地 为 这 些 集合 中 的 元 素 建立 测试 。 
2.6.2 节 中 的 代码 测试 所 有 元 素 ， 以 确定 是 否 有 任何 元 素 为 nuLL。 你 可 以 像 这 样 轻松 地 建立 
测试 ， 用 以 确定 : 

。 是 否 有 任何 数值 元 素 大 于 指定 的 最 大 值 ; 
。 是 否 有 任何 数值 元 素 小 于 指定 的 最 小 值 ; 
。 是 否 有 任何 字符 串 元 素 包 含 一 组 指定 的 字符 ; 
。 是 否 有 任何 数据 对 象 填充 了 它们 的 所 有 字段 ， 
。 你 可 能 提出 的 任何 其 他 问题 。 


TrueForAll 方法 接受 一 个 名 为 match 的 泛 型 委托 Predicate<T>， 并 返回 一 个 布尔 值 。 
public bool TrueForAll(Predicate<T> match) 
match 参数 确定 TrueForALl 方法 是 否 应 该 返回 true 或 false, 


TrueForAll 方法 实质 上 由 一 个 循环 组 成 ， 该 循环 用 于 遍历 集合 中 的 所 有 元 素 。 在 这 个 循环 
内 调用 match 委托 。 如 果 该 委托 返回 true， 就 继续 处 理 集合 中 的 下 一 个 元 素 。 如 果 该 委托 
返回 faLtse， 就 停 目 处理， 并 且 由 TrueForALL 方法 返回 false, Apt TrueForAll 方法 遍历 
完 集 合 中 的 所 有 元 素 ， 并 且 match 委托 没有 为 任何 元 素 返 回 一 个 false 值 ，TrueForALL 77 
法 就 会 返回 true。 


并 不 存在 FalseForAU 方法 ， 不 过 你 可 以 逆转 逻辑 并 且 使 用 TrueForAtt 来 完成 同样 的 






























































List<string> strings = new List<string>() {null, null, null, null}; 


// 确定 列表 中 是 否 全 部 为 nuLL 值 
string str = strings.TrueForAll(delegate(string val) 





if (val == null) 
return true; 
else 
return false; 
}).ToString(); 


// 显示 结果 

Console.WriteLine(str); 
另外 一 个 要 考虑 的 因素 是 TrueForAll 在 第 一 次 条 件 不 为 true 时 停止 。 这 意味 着 并 不 是 所 
有 的 节点 都 进行 了 检查 。 假 若 有 一 个 包含 文件 或 资源 的 数组 需要 进行 处 理 或 释放 ， 你 将 需 
要 迭代 所 有 元 素 ， 即 使 在 检查 过 程 中 执行 的 操作 失败 了 也 是 如 此 。 在 这 种 情况 下 ， 你 想 注 
意 是 否 其 中 的 任何 元 素 失 败 了 ， 但 访问 Array 或 List<T> 中 的 每 个 元 素 并 执行 操作 仍然 是 
很 重要 的 。 
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26.4 ”参考 
MSDN 文档 中 的 “Array 2” “List<T> 类 ”和 “TrueForALL 方法 ”主题 。 


2.7 ”创建 自 定义 枚 举 器 


2.7.1 问题 


你 需要 向 一 个 类 中 添加 foreach 支持 ， 但 是 通常 用 于 添加 选 代 器 的 方式 〈 即 在 类 型 上 实现 
IEnumerable 并 从 一 个 成 员 函 数 返 回 指向 这 个 TEnumerable 的 引用 ) 并 不 足够 灵活 。 除 了 简 
单 地 从 第 一 个 元 素 选 代 到 最 后 一 个 元 素 之 外 ， 还 需要 从 最 后 一 个 元 素 选 代 到 第 一 个 元 素 ， 
并 且 需 要 能 够 在 每 次 选 代 时 跨越 或 跳 过 预定 义 数量 的 元 素 。 你 想 使 所 有 这 些 类 型 的 迭代 器 
可 供 你 的 类 使 用 。 


2.7.2 解决 方案 


例 2-4 中 所 示 的 Container<T> 类 充当 一 个 名 为 internalList 的 私有 List<T> 的 容器 。 我 们 
实现 了 Container， 因 此 可 以 在 foreach 循环 中 使 用 它 来 遍历 私有 internaLList。 
Gil 2-4: GE AE SORTS 


public class Container<T> : IEnumerable<T> 


{ 




















public Container() { } 


private List<T> _internalList = new List<T>(); 





// 这 个 迭代 器 从 头 到 尾 迭 代 每 一 个 元 素 
public IEnumerator<T> GetEnumerator() =>  internallist.GetEnumerator(); 








// TRAE RAE OE BI AIK I T7628 
public IEnumerable<T> GetReverseOrderEnumerator() 


{ 
foreach (T item in ((IEnumerable«T2) internallist).Reverse()) 
yield return item; 


j 
// 这 个 迭代 器 从 头 到 尾 和 迭代 每 一 个 元 素 , 按 预 定义 的 大 小 步 进 


public IEnumerable<T> GetForwardStepEnumerator(int step) 


{ 





foreach (T item in _internalList.EveryNthItem(step)) 
yield return item; 


} 
// ZAER E MEFR IRE — T1 7038 S AEK E 


public IEnumerable<T> GetReverseStepEnumerator(int step) 





{ 
foreach (T item in ( 
(IEnumerable<T>)_internalList).Reverse().EveryNthItem(step)) 
yield return item; 
} 





#region IEnumerable Members 
IEnumerator IEnumerable.GetEnumerator() => GetEnumerator(); 
#endregion 


public void Clear() 


{ 
_internalList.Clear(); 
} 
public void Add(T item) 
{ 
_internalList.Add(item) ; 
} 
public void AddRange(ICollection<T> collection) 
{ 
_internalList.AddRange(collection); 
} 


2.7.3 讨论 

迭代 器 提供 了 一 种 容易 的 方法 ， 使 用 我 们 熟悉 的 foreach 循环 构造 在 对 象 内 从 一 个 数据 项 
移 到 另 一 个 数据 项 。 该 对 象 可 以 是 数组 、 集 合 或 者 革 种 其 他 类 型 的 容器 。 这 类 似 于 使 用 
for 循环 手动 遍历 数组 中 包含 的 每 个 数据 项 。 事 实 上 ， 可 以 建立 一 个 使 用 for 循环 或 任何 
其 他 循环 构造 的 从 代 器 ， 将 循环 构造 作为 输出 对 象 中 的 每 个 数据 项 的 机 制 。 事 实 上 ， 其 至 
不 必 使 用 循环 构造 。 下 面 的 代码 是 完全 有 效 的 。 


public static IEnumerable<int> GetValues() 
{ 

yield return 10; 

yield return 20; 

yield return 30; 

yield return 100; 
} 


利用 foreach 循 坏 ， 不 必 担 心 要 检查 列表 的 末尾 ， 因 为 它 不 能 越 出 列表 的 边界 。 关 于 
foreach 循环 和 迭代 器 的 最 佳 优点 是 ， 不 必 知 道 如 何 访问 其 容器 内 的 元 素 列 表 。 事 实 上 ， 
你 甚至 不 必 访 问 元 素 的 列表 ， 因 为 容器 上 实现 的 返 代 器 成 员 会 为 你 做 这 项 工作 。 
为 了 了 解 foreach 在 这 里 的 作用 ， 让 我 们 来 看 一 下 遍历 Container 类 的 代码 。 
// 迭代 容器 对 象 
foreach (int i in container) 
Console.WriteLine(i); 


在 这 段 代 码 运行 时 ，foreach 将 执行 以 下 几 个 操作 。 
(1) 使 用 IEnumerator.GetEnumerator() 从 容器 中 获取 枚 举 器 。 
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(2) ili] IEnunerator.Current 属性 以 获取 当前 对 象 〔int)， 并 将 其 置 于 中 。 

(3) 调 用 IEnumerator.MoveNext()。 如 果 MoveNext 返回 true， 就 返回 到 第 2 步 ， 否 则 结束 
循环 。 

Container 类 包含 一 个 数据 项 的 私有 List， 名 为 internaLList。 这 个 类 中 有 以 下 4 个 迭代 

器 成 员 。 


e GetEnumerator 














e GetReverseOrderEnumerator 
e GetForwardStepEnumerator 


e GetReverseStepEnumerator 


GetEnunerator Aik A 8 — JG Bl Bes — TIL seid  internallist 中 的 每 个 元 素 。 与 其 
他 迭代 器 类 似 ， 这 个 运 代 器 使 用 for 循环 输出 internalList 中 的 每 个 元 素 。 


GetReverseOrderEnumerator 方法 在 其 get 访问 器 中 实现 了 一 个 返 代 器 (set 访问 器 不 能 是 
友 代 器 )。 这 个 返 代 器 在 设计 上 非常 类 似 于 GetEnumerator 方法 ， 只 不 过 foreach 循环 在 
相反 方向 上 操作 internaLList， 这 是 使 用 IEnumerabLe<T>.Reverse 扩展 方法 实现 的 。 最 
Ja PAA IK FRE AE GetForwardStepEnumerator 和 GetReverseStepEnumeraror， 在 设计 上 分 别 

类 似 于 GetEnumerator 和 GetReverse0rderEnumerator。 其 主要 区 别 是 ，foreach 循环 使 用 
EveryNthItem 扩展 方法 跳 过 internalList 中 指定 数量 的 数据 项 。 


public static IEnumerable<T> EveryNthItem<T>(this IEnumerable<T> enumerable, 




















int step) 
{ 
int current = 0; 
foreach (T item in enumerable) 
{ 
++current; 
if (current % step == 0) 
yield return item; 
} 
} 


另外 要 注意 ， 只 有 GetEnumerator 方法 必须 返回 IEnumerator«T» 接口 ， 其 他 三 个 迭代 器 都 
必须 返回 IEnumerable<T> 接口 。 


为 了 从 第 一 个 元 素 到 最 后 一 个 元 素 遍 历 Container 对 象 中 的 每 个 元 素 ， 可 使 用 以 下 代码 。 


Container<int> container = new Container<int>(); 


J 将 数据 添加 到 容器 …… 
foreach (int i in container) 
Console.WriteLine(i); 


为 了 从 最 后 一 个 元 素 到 第 一 个 元 素 遍 历 Container 对 象 中 的 每 个 元 素 ， 可 使 用 以 下 代码 。 


Container<int> container = new Container<int>(); 


He 将 数据 添加 到 容器 …… 
foreach (int i in container.GetReverseOrderEnumerator()) 
Console.WriteLine(i); 


为 了 从 第 一 个 元 素 到 最 后 一 个 元 素 遍 历 Container 对 象 中 的 每 个 元 素 ， 同 时 跳 到 每 隔 一 个 























元 素 的 下 一 个 元 素 ， 可 使 用 以 下 代码 。 


Container<int> container = new Container<int>(); 
//…… 将 数据 添加 到 容器 …… 

foreach (int i in container.GetForwardStepEnumerator(2)) 
Console.WriteLine(i); 


为 了 从 最 后 一 个 元 素 到 第 一 个 元 素 遍 历 Container 对 象 中 的 每 个 元 素 ， 同 时 跳 到 所 有 每 隔 
两 个 元 素 的 第 三 个 元 素 ， 可 使 用 以 下 代码 。 
Container<int> container = new Container<int>(); 
//…… 将 数据 添加 到 容器 …… 
foreach (int i in container.GetReverseStepEnumerator(3)) 
Console.WriteLine(i); 


在 后 两 个 示例 中 ， 返 代 器 方法 接受 一 个 整数 值 step， 它 确定 将 跳 过 多 少 个 元 素 。 


最 后 一 点 关于 yield 的 说 明 ， 虽 然 在 Lock 语句 内 使 用 yield 在 技术 上 是 可 行 的 (参见 9.9.3 
市 了 解 Lock 的 更 多 信息 )， 但 是 你 应 当 避 免 这 样 做 ， 因 为 它 可 能 导致 应 用 程序 内 的 死 锁 。 
yield 语句 后 执行 的 代码 可 能 会 将 lock 带 出 并 导致 死 锁 。lock 内 的 代码 可 能 会 在 另 一 个 线 
程 上 恢复 〈 因 为 在 yield 之后， 代码 并 不 需要 在 原 线程 上 恢复 )， 因 此 可 能 会 在 建立 锁 的 线 
程 之 外 的 另 一 个 不 同 的 线程 解锁 。 





























2.74 参考 


MSDN x fü rp By "3k fC BE” “yield” “IEnumerator #2 O " “IEnumerable(T) 接口 ”和 
"IEnumerable 接口 ”主题 ， 以 及 范例 9.9 (BN 9.9 35), 


2.8 处 理 finaLLy 语 句 块 和 迭代 器 


2.8.1 问题 

你 加 迭代 器 中 添加 了 一 个 try-finally 语句 块 ， 并 且 注 意 到 finally 块 并 没有 按 所 想 的 那 
样 执行 。 

2.8.2 解决 方案 

在 GetEnumerator 迭代 器 中 用 一 个 try 块 包围 迭代 代码 ， 并 在 该 try 块 后 接 一 个 finally 
块 ， 代 码 如 下 所 示 。 


public class StringSet : IEnumerable<string> 


( 














private List<string> items = new List<string>(); 


public void Add(string value) 
{ 


} 


_items.Add(value); 
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public IEnumerator<string> GetEnumerator() 











{ 
try 
{ 
for (int index = 0; index < _items.Count; indext++) 
{ 
yield return (_items[index]); 
} 
} 
// 不 能 在 迭代 器 中 使 用 catch 语 句 块 
finally 
{ =x: 
// 仅 在 foreach 循 环 结束 后 执行 (包括 yteLd 中 断 时 ) 
Console.WriteLine("In iterator finally block"); 
} 
} 


#region IEnumerable Members 
IEnumerator IEnumerable.GetEnumerator() => GetEnumerator(); 


#endregion 


} 
调用 这 个 迭代 器 的 foreach 代码 如 下 所 示 。 


// 创 建 一 个 StringSet 对 象 并 填 入 数据 
StringSet strSet = 
new StringSet() 
{"item1", 
"item2", 
"item3", 
"item4", 
"item5"}; 





// {sFAGetEnumeratori& {tz 
foreach (string s in strSet) 
Console.WriteLine(s); 


运行 这 段 代码 时 ， 将 显示 以 下 输出 。 


item1 
item2 
item3 
item4 
item5 
In iterator finally block 


2.8.3 讨论 

你 可 能 认为 这 段 代 码 的 输出 将 在 显示 strSet 对 象 中 的 每 个 数据 项 之 后 显示 In iterator 
finally block 字符 串 。 不 过 ， 这 不 是 在 迭代 器 中 处 理 finally 块 的 方式 。 仅 当 和 迭代 完成 之 
后 ， 代 码 执行 离开 foreach 循环 时 (比如 ， 当 遇 到 break, return 或 throw 语句 时 )， 或 者 
当 执 行 yield break 语句 时 ， 才 会 调用 与 迭代 器 成 员 体内 包含 yield 返回 语句 的 try 块 关 




















联 的 所 有 Finally 块 ， 从 而 有 效 地 终止 迭代 器 。 


为 了 查看 和 迭代 器 如 何 处 理 catch 和 finally 语句 块 ( 注 意 ， 包 含 yield 语句 的 try 块 内 不 
能 包含 catch 块 )， 思 考 以 下 代码 。 


/// 创 建 一 个 StringSet 对 象 并 填 入 数据 
StringSet strSet = 
new StringSet() 
{"item1", 
"item2", 
"item3", 
"item4", 
"item5"}; 











// 显示 Stringset 对 象 中 的 所 有 数据 





try 
{ 
foreach (string s in strSet) 
{ 
try 
t 
Console.WriteLine(s); 
// 强 制 引发 异常 
//throw new Exception(); 
catch (Exception) 
{ 
Console.WriteLine("In foreach catch block"); 
} 
finally 
{ € 
// 每 次 迭代 时 执行 
Console.WriteLine("In foreach finally block"); 
} 
} 
} 
catch (Exception) 
{ 
Console.WriteLine("In outer catch block"); 
} 
finally 
// 每 次 迭代 时 执行 
Console.WriteLine("In outer finally block"); 
} 


假定 使 用 了 原始 的 StringSet.GetEnumerator 方法 〈 即 包含 try-finally 语句 块 的 方法 )， 
将 会 看 到 以 下 行为 。 
如 果 没 有 异常 发 生 ， 将 看 到 如 下 输出 。 

item1 

In foreach finally block 


item2 
In foreach finally block 
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item3 

In foreach finally block 
item4 

In foreach finally block 
item5 

In foreach finally block 
In iterator finally block 
In outer finally block 


我 们 看 到 ， 每 次 迭代 都 会 执行 foreach 循环 内 的 finally HAR, Hit, MAA AB 
完成 之 后 ， 才 会 执行 迭代 器 内 的 finally AR, Ib, HERBIE CaN Finally 语句 块 
将 会 在 包装 foreach 循环 的 finally 语句 块 之 前 执行 。 


如 果 在 处 理 第 二 个 元 素 期 间 ， 迭 代 器 自身 发 生 异常 ， 那 么 将 会 显示 如 下 输出 。 


item1 

In foreach finally block 
(Exception occurs here...) 

In iterator finally block 

In outer catch block 

In outer finally block 


我 们 注意 到 ， 一 旦 引发 异常 ， 就 会 执行 迭代 器 内 的 finally 语句 块 。 如 果 你 只 需 在 异常 发 
生 之 后 执行 清理 工作 ， 这 会 是 很 有 用 的 。 如 果 没 有 蜡 稼 发 生 ， 那 么 直到 友 代 器 执行 完成 才 
Zu finally 语句 块 。 在 迭代 器 的 finally 语句 块 执行 之 后 ，foreach 循环 外 部 的 catch 
语句 块 将 会 捕获 异常 。 此 时 可 以 处 理 或 重新 引发 异常 。 一 旦 处 理 完 这 个 catch 语句 块 ， 就 
会 执行 外 层 finally 语句 块 。 
注意 ， 永 远 不 给 foreach 循环 内 的 catch 语句 块 提 供 处 理 异常 的 机 会 。 这 是 由 于 对 应 的 try 
语句 块 没 有 包含 对 友 代 器 的 调用 。 


如 果 在 foreach 循环 内 处 理 第 二 个 元 素 期 间 发 生 异 常 ， 那 么 将 会 显示 如 下 输出 。 


item1 

In foreach finally block 
(Exception occurs here...) 

In foreach catch block 

In foreach finally block 

In iterator finally block 

In outer finally block 


注意 ， 在 这 种 情况 下 ， 首 先 执行 foreach 循环 内 的 catch 和 finally 语句 块 ， 然 后 执行 迭 
代 器 的 finally 语句 块 ， 最 后 执行 外 层 finally 语句 块 。 


E EAS (Cs LIT] catch FA finally 语句 块 的 工作 方式 将 帮助 你 在 正确 的 位 置 添加 catch 
和 finally 语句 块 。 如 果 需 要 在 迭代 完成 之 后 立即 执行 一 次 finally 语句 块 ， 可 以 将 该 
finally 语句 块 添 加 到 迭代 器 方法 中 。 不 过 ， 如 果 希 望 每 次 迭代 都 执行 finally 语句 块 ， 
就 需要 将 finally 语句 块 置 于 foreach 循环 体内 。 

如 果 需 要 在 迭代 器 异常 发 生 之 后 立即 捕获 它们 ， 就 应 该 考虑 将 foreach 循环 包装 在 一 个 
try-catch 语句 块 中 。foreach 循环 内 的 任何 try-catch 语句 块 都 将 错过 从 迭代 器 引发 的 
异常 。 
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2.84 参考 


MSDN xe¥HAY “try-catch” "3k[C23" “yield” “IEnumerator 接口 ”和 “IEnumerablte 接 





2.9 


2.9.1 


口 ”主题 。 


在 类 中 实现 能 套 的 foreach 功 能 


问题 


你 需要 一 个 类 ， 它 包含 一 个 对 象 列 表 ， 其 中 每 个 对 象 也 包含 一 个 对 象 列表 。 你 希望 以 如 下 
AE HIER) foreach 循环 遍历 外 层 和 内 层 列表 中 的 所 有 对 象 。 


foreach (Group<Item> subGroup in topLevelGroup) 








// 操作 组 


foreach (Item item in subGroup) 


// 操作 数据 项 


2.9.2 ”解决 方案 








的 List<Tr>， 并 且 每 个 Group 对 象 都 包含 一 个 List<Item>。 


例 2-5: 在 类 中 实现 foreach 功能 


public class Group<T> : IEnumerable<T> 


{ 





public Group(string name) 


{ 
} 


this.Name = name; 


private List<T> _groupList = new List<T>(); 
public string Name { get; set; } 

public int Count => _groupList.Count; 
public void Add(T group) 

f _groupList.Add(group); 

} 


IEnumerator IEnumerable.GetEnumerator() => GetEnumerator(); 


public IEnumerator<T> GetEnumerator() => _groupList.GetEnumerator(); 


在 类 上 实现 IEnumerable<T> 接口 。 例 2-5 中 所 示 的 Group 类 包含 一 个 可 以 保存 Group 对 象 
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public class Item 


{ 
public Item(string name, int Location) 
{ 
this.Name = name; 
this.Location = location; 
} 
public string Name { get; set; } 
public int Location { get; set; } 
} 


2.9.3 


在 C# 语言 
了 。 在 .NET Framework 3.0 之 前 的 版 本 


讨论 





IEnumerable 接 





， 使 用 迭代 器 在 类 中 构建 功能 从 而 用 foreach 循环 志 历 它 变 得 容易 多 


中 ， 不 仅 必 须要 在 希望 可 枚 举 的 类 型 上 实现 





O, i SE ERR ESCH IEnumerator 接口 。 然 后 必须 在 这 个 岁 套 类 中 手 





动 编写 MoveNext 和 Reset 方法 以 及 Current att, 3 fas UE PRU ES 3X TREK T TE 














移交 给 CH 编译 器 。 如 果 编 写 一 个 旧式 的 枚 举 器 ， 
public class GroupEnumerator<T> : IEnumerator 
{ 
public T[] _items; 
int position = -1; 
public GroupEnumerator(T[] list) 
{ 
_items = list; 
} 
public bool MoveNext() 
{ 
position++; 
return (position < _items.Length); 
} 
public void Reset() 
{ 
position = -1; 
} 
public object Current 
{ 
get 
{ 
try 
{ 
return _items[position]; 
} 
catch (IndexOutOfRangeException) 
{ 
throw new InvalidOperationException(); 
} 





代码 看 起 来 将 如 下 所 示 。 


} 


这 会 在 Group<T> 类 上 修改 IEnumerator .GetEnumerator 方法 ， 如 下 所 示 。 


IEnumerator IEnumerable.GetEnumerator() => 
new GroupEnumerator<T>(_groupList.ToArray()); 


利用 该 方法 的 代码 如 下 所 示 。 


IEnumerator enumerator = ((IEnumerable)hierarchy).GetEnumerator(); 
while (enumerator .MoveNext()) 


{ 
Console.WriteLine(((Group<Item>)enumerator.Current).Name); 
foreach (Item i in ((Group<Item>)enumerator.Current) ) 
{ 
Console.WriteLine(i.Name) ; 
} 
} 


如 果 你 不 必 这 样 做 ， 难 道 不 感到 高 兴 吗 ? FEE ERM ae, AE ae OREKA aE 
代码 。 

为 了 使 foreach 循环 能 够 使 用 一 个 类 ， 需 要 包含 一 个 迭代 器 。 迫 代 器 可 以 是 一 个 方法 、 一 
个 运算 符 重 载 或 者 一 个 属性 的 get 访问 器 。 它 返回 一 个 System.Collections.IEnumerator, 
System.Collections.Generic.IEnumerator<T>, System.Collections.IEnumerable 或 System. 
Collections.Generic.IEnumerable<T>, MASA b> yield 语句 。 


用 于 本 范例 的 代码 划分 在 两 个 类 中 。 容 器 类 是 Group 类 ， 包 含 Group<Item> 对 象 的 List, 
Group 对 象 也 包含 一 个 List， 但 是 这 个 List 包含 Item 对 象 。 为 了 枚 举 包含 的 列表 ，Group 
类 实现 了 IEnumerable 接口 。 因 此 它 包含 一 个 GetEnumerator 迭代 器 方 法 ， 该 方法 返回 一 个 
IEnumerator。 类 结构 如 下 所 示 。 

Group (Implements IEnumerable<T>) 


Group (Implements IEnumerable<T>) 
Item 


通过 检查 Group 类 ， 你 可 以 看 出 如 何 构造 可 供 foreach 循环 使 用 的 类 。 这 个 类 包含 以 下 

各 项 。 

。 一 个 简单 的 List<T>， 将 由 类 的 枚 举 器 遍历 它 。 

。 一 个 属性 Count， 它 将 返回 List<T> 中 的 元 素 个 数 。 

。 一 个 迭代 器 方法 GetEnumerator， 它 是 由 IEnumerable<T> 接口 定义 的 。 该 方法 将 在 
foreach 循环 执行 每 次 迭代 时 输出 一 个 特定 的 值 。 

。 一 个 方法 Add， 它 会 将 类 似 Subgroup 这 样 的 实例 添加 到 List<T> rp, 

。 一 个 方法 GetGroup， 它 将 从 List<T> 中 返回 一 个 类 型 化 的 实例 ， 如 Subgroup, 


为 了 创建 Subgroup 类 ， 可 以 遵循 与 Group 类 相同 的 模式 ， 只 不 过 Subgroup 类 包含 一 个 


List<Item>, 
































Iz] 
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最 后 一 个 类 是 Item。 该 类 位 于 这 个 结构 的 最 低级 别 上 ， 并 且 包 含 了 数据 。 它 被 组 织 在 
Subgroup 对 象 内 ， 所 有 这 些 Subgroup 对 象 都 包含 在 Group 对 象 中 。 这 个 类 并 没有 任何 与 众 
不 同 的 地 方 ， 它 只 是 包含 数据 以 及 用 于 设置 和 获取 该 数据 的 方式 。 

使 用 这 些 类 十 分 简单 。 下 面 的 方法 显示 了 如 何 创建 包含 多 个 Subgroup 对 象 的 Group 对 象 ， 
这 些 Subgroup 对 象 依次 又 包含 多 个 Item 对 象 。 


public static void CreateNestedObjects() 


























{ 

Group<Group<Item>> hierarchy = 
new Group<Group<Item>>("root") { 

new Group<Item>("subgroup1i"){ 
new Item("item1",100), 
new Item("item2",200)}, 

new Group<Item>("subgroup2"){ 
new Item("item3",300), 
new Item("item4",400)]); 

IEnumerator enumerator - ((IEnumerable)hierarchy).GetEnumerator(); 

while (enumerator.MoveNext()) 

{ 
Console.WriteLine(((Group<Item>)enumerator.Current).Name) ; 
foreach (Item i in ((Group<Item>)enumerator.Current) ) 
{ 

Console.WriteLine(i.Name); 
} 

} 

// 读 回 数据 

DisplayNestedObjects(hierarchy); 

} 


CreateNestedObjects 方法 首先 创建 Group 类 的 一 个 hierarchy 对 象 ， 然 后 在 其 中 创建 两 个 
子 组 ， 名 为 subgroup1 和 subgroup2。 每 个 子 组 对 象 又 被 依次 填充 了 两 个 Item 对 象 ， 分 别 
名 为 iteml、item2、item3 和 item4, 


下 一 个 方法 显示 了 如 何 读 取 在 CreateNestedObjects 方法 中 创建 的 Group 对 象 内 包含 的 所 有 
Item 对 象 。 


private static void DispLayNested0bjects(Group<Group<Item>> topLevelGroup) 


{ 
Console.WriteLine($"topLevelGroup.Count: {topLevelGroup.Count}"); 
Console.WriteLine($"topLevelGroupName: {topLevelGroup.Name}") ; 


// 外 部 的 foreach 和 迭代 topLeveLGroup 对 象 中 的 所 有 对 象 


foreach (Group<Item> subGroup in topLevelGroup) 


{ 





Console.WriteLine($"\tsubGroup.SubGroupName: {subGroup.Name}"); 
Console.WriteLine($"\tsubGroup.Count: {subGroup.Count}"); 


// 内 部 的 foreach 和 迭代 当前 SubGroup 对 象 中 的 所 有 对 象 


foreach (Item item in subGroup) 


{ 








Console.WriteLine($"\t\titem.Name: {item.Name}"); 





Console.WriteLine($"\t\titem.Location: {item.Location}"); 
} 
} 
} 


该 方法 将 显示 如 下 结果 。 


topLevelGroup.Count: 2 

topLevelGroupName: root 
subGroup.SubGroupName:  subgroupi 
subGroup.Count: 2 

















item.Name: itemi 
item.Location: 100 
item.Name: item2 


item.Location: 200 
subGroup.SubGroupName:  subgroup2 
subGroup.Count: 2 


item.Name: item3 
item.Location: 300 
item.Name: item4 


item.Location: 400 


在 这 里 可 以 看 到 ， 外 层 foreach 循环 用 于 遍历 顶级 Group 对 象 中 存储 的 所 有 Subgroup 对 
象 ， 内 层 foreach 循环 用 于 遍历 当前 Subgroup 对 象 中 存储 的 所 有 Item 对 象 。 


2.94 参考 


MSDN x #4 HAY “ER HE” "yield" “IEnumerator #2 O " “IEnumerable(T) 接口 ”和 
“TEnumerable 接口 ”主题 。 


2.10 使 用 线程 安全 的 字典 进行 并 发 访问 ， 不 手 
动 加 锁 


2.10.1 问题 


你 需要 创建 一 个 从 多 个 线程 中 并 发 读 写 的 键 值 对 的 集合 ， 并 且 不 需要 手动 使 用 同步 原 语 来 
保护 它 。 


2.10.2 解决 方案 

使 用 ConcurrentDictionary<Tkey, TValue> 容纳 数据 项 并 以 线程 安全 的 方式 来 访问 它们 。 
举例 来 说 ， 考 虑 一 个 模拟 情形 ， 球 迷 到 一 个 体育 馆 去 观看 他 们 喜爱 的 体育 赛事 〈 超 级 碗 、 
世界 杯 、 世 界 系列 赛 或 者 ICC 世界 板 球 联盟 锦标 赛 )， 并 且 场 馆 仅 有 若干 个 人口 。 

首先 ， 我 们 需要 一 些 球迷 并 且 记 录 他 们 的 姓名 、 何 时 入 场 以 及 通过 哪个 人 口 人 场 。 


public class Fan 


( 
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public string Name { get; set; } 
public DateTime Admitted { get; set; } 
public int AdmittanceGateNumber { get; set; } 


} 
// 设置 一 个 参加 活动 的 球迷 名 单 


List<Fan> fansAttending = new List<Fan>(); 
for (int i = 0; i < 100; i++) 

fansAttending.Add(new Fan() { Name = "Fan" + i }); 
Fan[] fans = fansAttending.ToArray(); 


每 个 入 口 每 次 只 能 有 一 个 人 入 场 ， 并 且 在 如 此 拥挤 的 活动 中 ， 入 口 通常 都 有 摄像 头 监 控 。 
我 们 将 用 一 个 静态 的 ConcurrentDictionary<int，Fan> 来 表示 体育 馆 的 入 口 以 及 当前 在 入 
HJ Fan， 并 用 一 个 静态 布尔 变量 (monitorGates) 来 表明 何 时 入 口 不 再 需要 监控 (也 就 是 
所 有 球迷 都 已 入 场 的 时 候 )。 


private static ConcurrentDictionary<int, Fan> stadiumGates = 
new ConcurrentDictionary<int, Fan>(); 
































private static bool monitorGates = true; 


假设 活动 现场 共有 10 个 入 口 (gateCount)， 为 每 个 入 口 使 用 AdmitFans 方法 启动 一 个 
Task， 让 每 个 入口 能 够 进入 若干 球迷 。 还 要 为 每 个 和 人口 使 用 MonitorGate 方法 启动 一 个 对 
应 的 Task， 将 安全 监控 打开 。 当 所 有 球迷 都 入 场 后 ， 停 止 监控 入 口 。 

int gateCount = 10; 


Task[] entryGates = new Task[gateCount]; 
Task[] securityMonitors = new Task[gateCount]; 











for (int gateNumber = 0; gateNumber < gateCount; gateNumber++) 
{ 

// 有 趣 的 事实 : 

// 你 也 许 会 认为 当 for 循 环 中 的 gateNumber 变 化 时 ， 

// 侈 许 Fan 进 入 的 Task 在 创建 时 能 够 捕获 

//Task 在 创建 时 那 一 刻 的 值 (9、1、2 等 ) 

// 这 意味 着 就 算 你 为 人口 0 启动 了 一 个 Task， 

// 随 着 Task 创 建 后 循环 的 继续 

He 将 得 到 一 个 值 为 9 的 gateNunber 变 量 量 

/ /为 了 处 理 这 一 情 况 ， 我 们 将 值 赋予 一 个 局 部 变 量 以 修正 作用 域 ， 

// 并 且 你 想 要 的 值 可 以 被 Task 正 确 地 捕获 

int GateNum = gateNumber; 

int GateCount = gateCount; 

Action action = delegate () { AdmitFans(fans, GateNum, GateCount); }; 

entryGates[gateNumber] = Task.Run(action); 






































for (int gateNumber = 0; gateNumber < gateCount; gateNumber++) 


int GateNum = gateNumber; 
Action action = delegate () { MonitorGate(GateNum); }; 
securityMonitors[gateNumber] = Task.Run(action); 





await Task.WhenAll(entryGates); 


// 关闭 监控 

monitorGates = false; 
AdmitFans 执行 准许 一 部 分 球迷 通过 的 工作 ， 它 使 用 ConcurrentDictionary<TKey, TValue>. 
AddOrUpdate 方法 表示 Fan 位 于 入 口 处 ， 使 用 ConcurrentDictionary<TKey，TVaLue>， 
TryRemove 方法 表示 该 Fan 被 准许 进入 活动 现场 ， 代 码 如 下 所 示 。 


private static void AdmitFans(Fan[] fans, int gateNumber, int gateCount) 


{ 











Random rnd = new Random(); 

int fansPerGate = fans.Length / gateCount; 
int start = gateNumber * fansPerGate; 

int end = start + fansPerGate - 1; 

for (int f = start; f <= end; f++) 


Console.WriteLine($"Admitting {fans[f].Name} through gate {gateNumber}"); 
var fanAtGate = 
stadiumGates.AddOrUpdate(gateNumber, fans[f], 
(key, fanInGate) => 
{ 


Console.WriteLine($"{fanInGate.Name} was replaced by 
S'(fans[f].Name) in gate {gateNumber}"); 
return fans[f]; 


+ 


IDE 
// 执行 搜 身 检查 并 检查 门票 
Thread.Sleep(rnd.Next(500, 2000)); 
// 让 他 们 通过 入 口 
fans[f].Admitted = DateTime.Now; 
fans[f].AdmittanceGateNumber = gateNumber; 
Fan fanAdmitted; 
if(stadiumGates.TryRemove(gateNumber, out fanAdmitted) ) 
Console.WriteLine($"{fanAdmitted.Name} entering event from gate 
$"(fanAdmitted.AdmittanceGateNumber) on " + 
$"(fanAdmitted.Admitted.ToShortTimeString()]"); 
else // 如 果 不 能 允许 他 们 进入 ,保安 必须 扣留 他 们 
Console.WriteLine($"{fanAdmitted.Name} held by security " + 
$"at gate {fanAdmitted.AdmittanceGateNumber}"); 





+ 


} 
MonitorGate 通过 使 用 TryGetValue 方法 检查 ConcurrentDictionary<TKey, TValue> 来 观察 
指定 的 入 口 (gateNumber), MonitorGate 将 持续 监控 直到 monitorGates 标志 设置 为 faLse 
(在 Admit Fan Task 完成 之 后 )。 


private static void MonitorGate(int gateNumber) 


{ 








Random rnd = new Random(); 
while (monitorGates) 
{ 
Fan currentFanInGate; 
if (stadiumGates.TryGetValue(gateNumber, out currentFanInGate)) 
Console.WriteLine($"Monitor: {currentFanInGate.Name} is in Gate 


+ 
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$"{gateNumber}"); 
else 
Console.WriteLine($"Monitor: No fan is in Gate {gateNumber}"); 





// 等 待 然后 再 次 检查 入 口 
Thread.Sleep(rnd.Next(500, 5000)); 





2.10.3 讨论 

ConcurrentDictionary<TKey, TValue> 位 于 System.Collections.Concurrent fy % 2: iH] Ay, 
在 .NET 4.0 及 以 上 版 本 中 可 用 。 它 是 一 种 在 多 重读 写 的 情形 下 最 有 用 的 集合 。 如 果 你 在 初 
始 化 后 仅 需要 多 重读 ， 那 么 ImmutableDictionary<TKey, TValue> 是 一 个 更 好 的 选择 。 因 为 
集合 在 初始 化 后 是 不 可 变 的 ， 所 以 它 是 一 种 速度 更 快 的 可 读 集合 。 当 你 操作 一 个 不 可 变 字 
典 时 ， 会 创建 原始 字典 的 一 个 新 副本 。 这 一 过 程 的 代价 很 高 ， 因 此 应 该 仅 将 不 可 变 集 合用 
于 加 载 一 次 后 反复 读 写 的 情况 。 

注意 这 些 Immutable 类 并 不 是 核心 .NET Framework 类 库 中 的 一 部 分 ， 它 们 位 于 NuGet 包 
Microsoft.Bcl.Immutable 的 System.Collections.Immutable 程序 集 内 ， 你 需要 在 你 的 应 用 
程序 中 包含 这 个 包 。 

ConcurrentDictionary<TKey, TValue> 包含 一 些 会 导致 整个 集合 加 锁 的 属性 和 方法 ， 因 为 它 
们 需要 同时 操作 集合 中 的 所 有 数据 项 。 以 下 这 些 属性 会 返回 数据 的 “即时 ”快照 。 

。 Count 属性 

。 Keys 属性 

。 Values 属性 

。 ToArray 方法 


数据 的 一 个 “即时 ”表现 意味 着 在 枚 举 时 并 不 一 定 获得 当前 数据 。 如 果 需 要 字典 中 绝对 的 
当前 数据 ， 请 使 用 GetEnumerator 方法 ， 它 提供 了 一 个 用 于 遍历 字典 中 的 键 值 对 的 枚 举 器 。 
因为 GetEnumerator 保证 了 枚 举 器 在 并 发 更 新 时 都 可 以 安全 使 用 ， 并 且 不 需要 加 锁 ， 你 能 
够 在 底层 数据 改变 时 访问 它 。 参 考 MSDN 文档 中 的 “IEnumerabLe<T>.GetEnumerator” 主 
题 可 获得 更 详细 的 介绍 。 

LINQ 经 常 使 用 GetEnumerator 以 达成 它 的 目标 ， 因 此 你 可 以 用 一 个 LINQ 的 Select 方 法 
来 使 用 Keys 和 Values 属性 ， 以 避免 加 锁 带 来 的 不 利 影响 。 


var keys = stadiumGates.Select(gate => gate.Key); 
var values = stadiumGates.Select(gate => gate.Value); 


当 用 于 计数 时 ，LINQ 被 优化 为 在 支持 ICollection 接口 的 集合 上 使 用 Count 属性 ， 但 在 
本 例 中 这 不 是 我 们 想 要 的 。 下 面 的 例子 展示 了 Count 方法 的 逻辑 ， 如 果 可 枚 举 参 数 支持 
ICollection 或 者 ICollection<T>， 就 使 用 Count 属性 。 

























































































public static int Count<TSource>(this IEnumerable<TSource> source) 


{ 


if (source == null) 





fe 
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} 














然后 对 其 


var 


{ 
} 


ICollection«TSource» tSources = source as ICollection<TSource>; 
if (tSources != null) 


throw Error.ArgumentNull("source"); 


{ 
return tSources.Count; 
} 
ICollection collections = source as ICollection; 
if (collections != null) 
{ 
return collections.Count; 
} 


int num = 0; 
using (IEnumerator<TSource> enumerator = source.GetEnumerator()) 


{ 


while (enumerator .MoveNext()) 


{ 
} 


numr-; 


} 


return num; 


个 问题 ， 可 获取 一 个 不 支持 Collection 和 ICollection<T> 的 可 枚 举 数 据 项 集合 ， 
调用 Count(), 


count = stadiumGates.Select(gate => gate).Count(); 











Select 调用 返回 一 个 System.Ling.Enumerable.WhereSelectEnumerableIterator， 它 不 支持 
ICollection 或 ICoLLection<T>， 但 是 支持 GetEnumerator 。 


K 2-1 总 结 了 ConcurrentDictionary«TKey, TValue> 的 主要 数据 操作 方法 概况 。 
表 2-1: ConcurrentDictionary 的 操作 方法 










































































PE 何 时 使 用 

TryAdd 又 当 键 不 存在 时 添加 一 个 新 数据 项 

TryUpdate 如 果 当 前 值 可 用 ， 将 现 有 键 更 新 为 新 值 

Indexing 无 条 件 地 设置 字典 中 的 一 个 键 / 值 ， 无 论 键 存在 与 否 

AddOrUpdate j 一 个 委托 设置 字典 中 的 一 个 键 / 值 ， 可 以 根据 键 添 加 还 是 更 新 设置 不 同 记录 
GetOrAdd 获得 一 个 键 的 值 ， 或 者 初始 化 键 的 值 并 返回 该 值 (延迟 初始 化 ) 

TryGetValue 获得 键 的 值 ， 或 者 返回 false 

TryRemove 移 除 键 对 应 的 值 ， 或 者 返回 false 











示例 代码 开始 的 输出 看 起 来 如 下 所 示 。 


Admitting FanO through gate 0 
Admitting Fan10 through gate 1 
Admitting Fan20 through gate 2 
Admitting Fan30 through gate 3 
Admitting Fan40 through gate 4 
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Fan0 entering event from gate 0 on 6:00 PM 
Admitting Fani through gate 0 
Fan20 entering event from gate 2 on 6:00 PM 
Fan10 entering event from gate 1 on 6:00 PM 
Admitting Fan11 through gate 1 
Fan30 entering event from gate 3 on 6:00 PM 
Admitting Fan31 through gate 3 
Admitting Fan21 through gate 2 
Fan40 entering event from gate 4 on 6:00 PM 
Admitting Fan41 through gate 4 
Admitting Fan50 through gate 5 
Fan11 entering event from gate 1 on 6:00 PM 
Admitting Fani2 through gate 1 
Fani entering event from gate 0 on 6:00 PM 


示例 代码 运行 中 途 监控 的 输出 看 起 来 如 下 所 示 。 


Admitting Fan17 through gate 1 

Fan6 entering event from gate 0 on 6:00 PM 
Admitting Fan7 through gate 0 

Fan26 entering event from gate 2 on 6:00 PM 
Admitting Fan27 through gate 2 

Fan36 entering event from gate 3 on 6:00 PM 
Admitting Fan37 through gate 3 

Monitor: Fani7 is in Gate 1 

Fan83 entering event from gate 8 on 6:00 PM 
Admitting Fan55 through gate 5 

Fani7 entering event from gate 1 on 6:00 PM 
Admitting Fani8 through gate 1 


示例 代码 最 后 的 输出 看 起 来 如 下 所 示 。 


Monitor: Fan97 is in Gate 9 

Monitor: No fan is in Gate 0 

Fan77 entering event from gate 7 on 6:00 PM 
Admitting Fan78 through gate 7 

Monitor: No fan is in Gate 1 

Fan97 entering event from gate 9 on 6:00 PM 
Admitting Fan98 through gate 9 

Monitor: No fan is in Gate 2 

Monitor: No fan is in Gate 
Monitor: No fan is in Gate 
Monitor: No fan is in Gate 
Monitor: No fan is in Gate 
Monitor: Fan78 is in Gate 7 
Monitor: No fan is in Gate 8 

Fan78 entering event from gate 7 on 6:00 PM 
Admitting Fan79 through gate 7 

Monitor: Fan98 is in Gate 9 

Monitor: No fan is in Gate 2 

Fan98 entering event from gate 9 on 6:00 PM 
Admitting Fan99 through gate 9 


nu 上 uU 
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Monitor: No fan is in Gate 1 
Monitor: No fan is in Gate 2 
Fan79 entering event from gate 7 on 6:00 PM 
Fan99 entering event from gate 9 on 6:00 PM 


2104 ”参考 


MSDN x #4 中 AY “IEnumerable<T>.GetEnumerator” 和 “ConcurrentDictionary<TKey， 
TValue>” W 





o 
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3.0 简介 


作为 一 种 值 类 型 ， 简 单 类 型 (simple type) 是 C# 中 内 建 类 型 的 一 个 子 集 ， 不 过 事实 上 
这 些 类 型 被 定义 为 NET Framework 类 库 (.NET FCL) 的 一 部 分 。 简 单 类 型 由 若干 数字 
类 型 和 一 个 bool 类 型 构成 。 这 些 数字 类 型 包括 一 个 十 进 制 类 型 (decimaL) 、 九 个 整数 类 
型 (byte, char, int, long, sbyte, short, unit, ulong 和 ushort) 以 及 两 个 浮 点 类 型 
(float 和 double), X 3-1 列 出 了 .NET Framework 中 的 简单 类 型 及 其 完全 限定 名 。 


表 3-1， 简单 数据 类 型 














全 名 别 名 取 值 范围 

System.Boolean bool true 或 false 

System.Byte byte 0-255 

System.SByte sbyte -128-127 

System.Char char 0~65535 

System.Decimal decimal -79 ,228,162,514,264, 337,593, 543,950, 335~79,228,162,514,264, 
337,593,543,950,335 

System.Double double -1.79769313486232e308~1.79769313486232e308 

System.Single float -3.40282347E+38~3.40282347E+38 

System. Int16 short -32768~32767 

System.Uinti6 ushort 0~65535 

System. Int32 int -2,147 ,483 ,648~2,147 ,483 ,647 

System.UInt32 uint 0~4,294,967,295 
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* 2 » 名 取 值 范围 
System. Int64 long -9 223,372,036 ,854,775,808~9 223,372,036 ,854,775,807 
System.UInt64 ulong 0~18 ,446,744,073,709,551,615 

















DEE rica Je THE, A BET RE Ee ELI TL EER, A BCH AY T RE AI 3-2 
所 示 。 
表 3-2: 浮 点 精度 








浮 点 类 型 精 度 
System.Single(float) 7 位 

System.Double(double) 15~16 位 
System.Decimal(decimal) 28~29 位 











在 使 用 浮 点 与 使 用 十 进 制 数 之 间 进 行 决策 时 ， 要 考虑 以 下 两 个 方面 
。 浮 点 供 科学 家 使 用 ， 设 计 用 于 表示 物理 学 中 精度 和 量 值 的 整个 范围 上 的 不 精确 量 。 

。 十 进 制 数 供 普通 人 使 用 ， 设 计 用 于 进行 十 进 制 计 算 ， 仅 需要 小 数 点 之 后 少量 的 数字 ， 或 
者 用 于 需要 准确 记录 每 一 分 钱 的 情况 〈 例 如 核对 支票 本 )。 


CH 为 各 种 数据 类 型 保留 的 关键 字 是 针对 类 型 的 完全 限定 名 称 的 简单 别名 。 因 此 ， 用 户 使 
用 类 型 名 还 是 保留 字 是 无 关 紧 要 的 ，C# 编译 器 将 生成 同样 的 代码 。 

要 注意 下 列 类 型 与 公共 语言 规范 (common language specification, CLS) 并 不 兼容 : sbyte、 
ubyte, uint 和 ulong。 结 果 可 能 导致 它们 不 被 其 他 NET 语言 支持 。 枚 举 隐 式 继承 自 
System.Enum， 后 者 又 继承 自 System.ValueType。 枚 举 有 着 单一 的 应 用 ， 描 述 一 个 特定 组 的 
数据 项 。 例 如 ， 颜 色 Red, Blue 和 Yellow 可 由 枚 举 ShapeColor 定义 ; 同样， 形状 Square, 
Circle fil Triangle 可 以 由 枚 举 Shape 定义 。 这 些 枚 举 如 下 所 示 。 











o 


















































enum ShapeColor 


Red, Blue, Yellow 


} 
enum Shape 
{ 
Square = 2, Circle = 4, Triangle = 6 
} 


枚 举 中 的 每 个 数据 项 接受 一 个 数字 值 ， 无 论 你 是 否 给 它 赋 过 值 。 由 于 编译 器 为 枚 举 中 的 每 
个 项 自动 添加 以 0 开头 并 且 递 增 1 的 数字 ， 因 此 上 述 定义 的 ShapeColor 枚 举 如 果 以 下 列 方 
式 定 义 ， 那 么 它 将 完全 相同 。 


enum ShapeColor 




















Red = 0,BLue = 1,Yellow = 2 
} 


枚 举 是 一 种 很 好 的 代码 文档 化 工具 。 例 如 ， 如 下 编写 的 代码 会 更 直观 。 
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ShapeColor currentColor = ShapeColor.Red; 
下 这 样 就 不 太 直 观 。 
int currentColor = 0; 


这 两 种 机 制 都 能 工作 ， 但 第 一 种 方法 容易 阅读 和 理解 ， 特 别 是 对 于 一 个 接管 其 他 人 代码 的 
新 开发 人 员 而 言 。 枚 举 对 保证 C# 中 的 类 型 安全 也 有 益处 ， 而 使 用 原始 的 int 不 能 提供 数 
据 安全 。CLR 将 枚 举 视 为 其 基础 类 型 的 成 员 ， 因 此 对 于 所 有 语言 它 并 非 都 是 类 型 安全 的 。 


3.1 把 二 进 制 数据 编码 为 base64 格 式 


3.1.1 问题 

你 有 一 个 byte[] 用 于 表示 一 些 二 进 制 信息 ， 比 如 位 图 。 你 需要 把 该 数据 编码 为 一 个 字符 
串 ， 以 便 可 以 通过 不 适合 传输 二 进 制 的 方式 (比如 电子 邮件 ) 发 送 它 。 

3.1.2 解决 方案 


使 用 Convert 类 的 静态 方法 Convert.ToBase64String， 可 以 把 bytel] 编码 为 其 对 应 的 
String, 





T 













































































static class DataTypeExtMethods 


{ 
public static string Base64EncodeBytes(this byte[] inputBytes) => 
(Convert. ToBase64String(inputBytes) ); 


} 


3.1.3 讨论 

把 字符 串 转 换 为 其 base64 Xon HU SHAR. BEIE ve A Hem A BIE it fill xc f 
中 ， 比 如 XML、 电 子 邮 件 消息 等 。 还 可 以 用 比 十 六 进 制 编码 更 简洁 的 格式 通过 HTTP, 
GET 和 POST 请 求 传输 base64 编码 的 数据 。 把 数据 转换 成 为 base64 格式 只 是 使 其 混淆 
而 不 会 对 其 加 密 ， 理解 这 一 点 是 很 重要 的 。 为 了 安全 地 把 数据 从 一 个 地 方 移 到 另 一 个 
地 方 ， 应 该 使 用 FCL 中 提供 的 加 密 算法 。 有 关 使 用 PCL 加 密 类 的 示例 ， 参 见 范例 11.4 
( 即 11.4 35), 

Convert 类 使 得 byte[] 与 String 之 间 的 编码 成 为 一 件 简单 的 事情 。 这 个 方法 的 参数 相当 灵 
活 ， 允 许 在 输入 字 节 数组 中 的 任意 位 置 开始 和 停止 转换 。 

为 了 把 位 图 文件 编码 为 可 以 发 送 到 某 个 目的 地 的 字符 串 ， 可 以 使 用 EncodeBitmapToString 
方法 。 


public static string EncodeBitmapToString(string bitmapFilePath) 


{ 


























byte[] image = null; 
FileStream fstrm = 
new FileStream(bitmapFilePath, 
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FileMode.Open, FileAccess.Read); 
using (BinaryReader reader = new BinaryReader(fstrm)) 


{ 
image = new byte[reader.BaseStream.Length]; 
for (int i = 0; i < reader.BaseStream.Length; i++) 
image[i] = reader.ReadByte(); 
} 


return image.Base64EncodeBytes(); 





个 字符 的 边界 上 插入 一 个 CRLF. 





MIME 标准 要 求 base64 编码 字符 串 每 一 行 的 长 度 为 76 个 字符 。 为 了 在 电子 
邮件 消息 中 作为 伐 入 式 MIME 附件 发 送 bmpAsstring 字符 串 ， 必 须 在 每 76 





将 base64 编码 的 字符 串 转 换 为 适用 于 MIME 的 字符 串 的 代码 展示 在 下 








Al 的 








MakeBase64EncodedStringForMime 方法 中 。 


public static string MakeBase64EncodedStringForMime(string base64Encoded) 
{ 
StringBuilder originalStr = new StringBuilder (base64Encoded) ; 
StringBuilder newStr = new StringBuilder(); 
const int mimeBoundary = 76; 
int cntr = 1; 
while ((cntr * mimeBoundary) < (originalStr.Length - 1)) 
{ 
newStr.AppendLine(originalStr.ToString(((cntr - 1) * mimeBoundary), 
mimeBoundary)); 
cntr4*; 


if (((cntr - 1) * mimeBoundary) < (originalStr.Length - 1)) 
{ 
newStr.AppendLine(originalStr.ToString(((cntr - 1) * mimeBoundary), 


((originalStr.Length) - ((cntr - 1) * mimeBoundary)))); 
} 


return newStr.ToString(); 


} 
要 把 编码 的 字符 串 解码 为 byte[] ， 参 见 范例 3.2 (Hl 3.2 11). 


3.1.4 参考 


范例 3.2 (HI 3.2 节 ) ; MSDN 文档 中 的 “Convert.ToBase64CharArray 方法 ”主题 。 


3.2 ”解码 base64 编 码 的 二 进 制 数据 


3.2.1 问题 





你 有 一 个 String， 其 中 包含 编码 为 base64 的 信息 ， 例 如 一 个 位 图 。 你 需要 把 此 数据 ( 它 可 








能 甘 入 在 电子 邮件 消息 中 ) 从 String 解码 为 byte[] ， 以 便 访 问 原始 的 二 进 制 数据 。 
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3.2.2 解决 方案 


使 用 Convert 类 的 静态 方法 Convert.FromBase64String， 可 以 将 编码 的 String 解码 为 其 对 





应 的 byte[]. 


static class DataTypeExtMethods 


{ 


public static byte[] Base64DecodeString(this string inputStr) 


{ 
byte[] decodedByteArray = 


Convert. FromBase64String(inputStr); 
return (decodedByteArray); 


} 


3.2.3 讨论 
Convert 类 的 静态 方法 FromBase64String 使 得 对 base64 编码 过 的 字符 串 进行 解码 成 为 一 
很 简单 的 事情 。 该 方法 会 返回 一 个 byte[]， 其 中 包含 String 解码 出 的 元 素 。 











件 


如 果 你 通过 电子 邮件 接收 到 一 个 已 经 转换 成 字符 串 的 文件 ， 比 如 图 像 文件 (bmp), skr 

















以 使 用 如 下 代码 将 其 转换 回 原始 的 位 图 文件 。 


// 使 用 3.1 节 中 的 编码 方法 以 得 到 编码 过 的 字 节 数组 

string bmpAsString = EncodeBitmapToString(Q" CSCBCover.bmp"); 
// 获得 一 个 要 写 和 的 临时 文件 名 

string bmpFile = Path.GetTempFileName() + ".bmp"; 























// 使 用 扩展 方法 解码 图 像 

byte[] imageBytes = bmpAsString.Base64DecodeString(); 

FileStream fstrm = new FileStream(bmpFile, 
FileMode.CreateNew, FileAccess.Write); 

using (BinaryWriter writer - new BinaryWriter(fstrm)) 








writer.Write(imageBytes); 


j 


在 这 段 代 码 中 ， 通 过 3.3.3 节 中 的 代码 获得 bmpAsString 变量 。imageBytes byte[] 是 转换 


回 byte[] 的 bmpAsString String， 然 后 将 其 写 回 到 磁盘 。 
要 将 bytel] 编码 为 String， 参 见 范例 3.1 (Bl 3.1 节 )。 


3.24 参考 


范例 3.1 (BN 3.145) ; MSDN 文档 中 的 “Convert.FromBase64CharArray 方法 ”主题 。 


3.3 把 作为 byte[] 返 回 的 字符 串 转 换 为 字符 串 


3.3.1 问题 








FCL 中 的 许多 方法 都 返回 一 个 byte[]， 因 为 它们 都 提供 了 一 种 字 节 流 服 务 ， 但 是 一 些 











程序 需要 通过 这 些 字 节 流 服务 传递 字符 串 。 下 面 是 其 中 的 一 些 方法 。 


System.Diagnostics.EventLogEntry.Data 
System.IO.BinaryReader.Read 
System.IO.BinaryReader.ReadBytes 
System.IO.FileStream.Read 
System.IO.FileStream.BeginRead 
System.IO.MemoryStream // Constructor 
System.IO.MemoryStream.Read 
System.IO.MemoryStream.BeginRead 
System.Net.Sockets.Socket.Receive 
System.Net.Sockets.Socket.ReceiveFrom 
System.Net.Sockets.Socket.BeginReceive 
System.Net.Sockets.Socket.BeginReceiveFrom 
System.Net.Sockets.NetworkStream.Read 
System.Net.Sockets.NetworkStream.BeginRead 
System.Security.Cryptography.CryptoStream.Read 
System.Security.Cryptography.CryptoStream.BeginRead 


E 许 多 情况 下 ， 这 个 byte[] 可 能 包含 ASCI 或 Unicode 编码 的 字符 。 你 需要 采用 一 种 方式 
重组 这 个 byte[] 得 原始 字符 串 。 


3.3.2 ”解决 方案 


为 了 把 ASCI 值 的 字 节 数组 转换 成 完整 的 字符 串 ， 使 用 ASCII Encoding 类 上 的 GetString 
方法 。 
byte[] asciiCharacterArray = {128, 83, 111, 117, 114, 99, 101, 


32, 83, 116, 114, 105, 110, 103, 128}; 
string asciiCharacters = Encoding.ASCII.GetString(asciiCharacterArray); 


为 了 把 Unicode 值 的 字 节 数组 转换 成 完整 的 字符 串 ， 使 用 Unicode Encoding 类 上 的 
GetString 方法 。 


byte[] unicodeCharacterArray = {128, 0, 83, 0, 111, 0, 117, 0, 114, 0, 99, 0, 
101, 0, 32, 0, 83, 0, 116, 0, 114, 0, 105, 0, 110, 
0, 103, 0, 128, 0); 
string unicodeCharacters - Encoding.Unicode.GetString(unicodeCharacterArray); 














i A 


ig 





3.3.3 讨论 

Encoding 类 的 GetString 方法 (通过 ASCII 属性 返回 ) 把 字 节 数组 中 包含 的 7 位 ASCII AE 
符 转 换 成 一 个 字符 串 。 对 于 任何 大 于 127 (0x7F) 的 值 ， 都 会 把 它 与 值 127 (Ox7F) 进行 
与 运算 ， 并 在 字符 串 中 显示 得 到 的 字符 值 。 例 如 ， 如 果 byte[] 包含 值 200 (0xC8), ， 则 会 
把 这 个 值 转换 为 72 (0x48)， 并 且 会 显示 72 H。 可 以 在 System.Text 命名 空间 
中 找到 Encoding 类 。GetString 方法 也 被 重 载 以 接受 。 该 方法 的 重 载 版 本 可 以 
把 字符 串 的 所 有 或 部 分 字符 转换 为 ASCII， 然 后 把 结 piii byte[] 内 的 指定 范围 中 。 


GetString 返回 一 个 字符 串 ， 其 中 包含 byte[] 转换 的 ASCH 字符 。 
Encoding 类 的 GetString 方法 (通过 Unicode 属性 返回 ) 把 Unicode 字符 转换 成 16 位 的 
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Unicode 值 。 可 以 在 System. Text 命名 空间 中 找到 Encoding X, GetString 方法 返回 一 个 字 
符 串 ， 甚 中 包含 byte[] 转换 的 Unicode 字符 。 


3.3.4 ”参考 


MSDN 文档 中 的 “ASCIIEncoding 25" All “UnicodeEncoding 类 ”主题 。 


3.4 ”把 字符 串 传 递 给 只 接受 byte[] 的 方法 


3.4.1 问题 
FCL 中 的 许多 方法 接受 由 字符 构成 的 byte[]， 而 不 是 string。 下 面 是 其 中 的 一 些 方法 。 


System.Diagnostics.EventLog.WriteEntry 
System.IO.BinaryWriter.Write 
System.IO.FileStream.Write 
System.IO.FileStream.BeginWrite 
System.IO.MemoryStream.Write 
System.IO.MemoryStream.BeginWrite 
System.Net.Sockets.Socket.Send 
System.Net.Sockets.Socket.SendTo 
System.Net.Sockets.Socket.BeginSend 
System.Net.Sockets.Socket.BeginSendTo 
System.Net.Sockets.NetworkStream.Write 
System.Net.Sockets.NetworkStream.BeginWrite 
System.Security.Cryptography.CryptoStream.Write 
System.Security.Cryptography.CryptoStream.BeginWrite 


在 许多 情况 下 ， 可 能 需要 把 一 个 string 传人 上 述 其 中 一 个 方法 或 者 其 他 某 个 只 接受 bytel] 
的 方法 中 。 你 需要 采用 一 种 方式 把 这 个 字符 串 分 解 成 byte[] 。 


3.4.2 ”解决 方案 
要 把 一 个 string 转换 为 ASCII 值 的 byte[]， 可 以 使 用 ASCII Encoding 类 的 GetBytes 方法 。 


byte[] asciiCharacterArray = {128, 83, 111, 117, 114, 99, 101, 
32, 83, 116, 114, 105, 110, 103, 128}; 
string asciiCharacters = Encoding.ASCII.GetString(asciiCharacterArray) ; 






































byte[] asciiBytes = Encoding.ASCII.GetBytes(asciiCharacters); 


要 把 一 个 string 转换 成 Unicode 值 的 byte[]， 可 以 使 用 Unicode Encoding 类 的 GetBytes 
方法 。 
byte[] unicodeCharacterArray = {128, 0, 83, 0, 111, 0, 117, 0, 114, 0, 99, 0, 
101, 0, 32, 0, 83, 0, 116, 0, 114, 0, 105, 0, 110, 


0, 103, 0, 128, 0); 
string unicodeCharacters - Encoding.Unicode.GetString(unicodeCharacterArray); 


byte[] unicodeBytes - Encoding.Unicode.GetBytes(unicodeCharacters); 
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3.4.3 ”讨论 

Encoding 类 的 GetBytes 方法 (3 x ASCII 属性 返回 ) 把 ASCI 字符 (包含 在 char[] 或 
string 中 ) 转换 成 7 位 ASCII 值 的 byte[]。 任 何 大 于 127 (Ox7F) 的 值 都 会 被 转换 为 ? F 
符 。 可 以 在 System. Text 命名 空间 中 找到 Encoding 2E, GetBytes 方法 也 被 重 载 以 接受 额外 
的 参数 。 该 方法 的 重 载 版 本 可 以 把 字符 串 中 的 所 有 或 部 分 字符 转换 成 ASCII， 然 后 把 结果 
存储 在 bytel] 内 的 指定 范围 内 ， 并 将 其 返回 给 调用 者 。 


Encoding 类 的 GetBytes 方法 (通过 Unicode 属性 返回 ) 把 Unicode 字符 转换 成 16 位 的 
Unicode 值 。 可 以 在 System.Text 命名 空间 中 找到 Encoding 4, GetBytes 方法 返回 一 个 
byte[]， 其 中 每 个 元 素 都 包含 字符 串 中 单个 字符 的 Unicode 值 
源 string 或 源 char[] 中 的 单个 Unicode 字符 对 应 bytel] H9 PF 7638. PA, TÉ 
byte[] B&F S HJ ASCH 值 。 

byte[] sourceArray = {83}; 
不 过 ， 为 了 使 byte[] 包含 字母 $ 的 Unicode 表示 ， 它 必须 包含 两 个 元 素 ， 如 下 所 示 。 

byte[] sourceArray2 = {83, 0}; 
Intel 体系 架构 使 用 小 端 (little-endian) 编码 方式 ， 这 意味 着 第 一 个 元 素 是 最 低 有 效 字 市 ， 
第 二 个 元 素 是 最 高 有 效 字 节 。 甚 他 体系 架构 可 能 使 用 大 端 (big-endian) 编码 方式 ， 与 小 端 
方式 相反 。UnicodeEncoding 类 同时 支持 大 端 和 小 端 编 码 。 使 用 UnicodeEncoding 实例 构造 
国 数 ， 可 以 构造 一 个 使 用 大 端 或 小 端 排序 的 实例 。 这 是 通过 使 用 下 面 两 个 构造 函 数 之 一 来 
完成 的 。 

public UnicodeEncoding (bool bigEndian, bool byteOrderMark); 

public UnicodeEncoding (bool bigEndian, bool byteOrderMark, 

bool throwOnInvalidBytes); 


第 一 个 参数 bigEndian 接受 一 个 布尔 参数 。 把 这 个 参数 设置 为 true 就 使 用 大 端 编码 ， 设 置 
为 false 则 使 用 小 端 编码 。 


此 外 ， 你 还 可 以 选择 指定 是 否 应 该 生成 字 节 顺 序 标记 (BOM) 报头 ， 以 便 文件 的 阅读 者 知 
道 使 用 的 是 大 端 编码 还 是 小 端 编码 。 


3.4.4 ”参考 


MSDN 文档 中 的 “ASCIIEncoding 类 ”和 “UnicodeEncoding 类 ”主题 。 
3.5 ”确定 一 个 字符 串 是 否 为 有 效 的 数字 


3.5.1 问题 
你 有 一 个 可 能 包含 一 个 数字 值 的 字符 串 ， 你 需要 知道 该 字符 串 是 否 包含 一 个 有 效 的 数字 。 
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3.5.2 ”解决 方案 


使 用 任意 数字 类 型 的 静态 TryParse 方法 。 例 如 ， 要 确定 一 个 字符 串 是 否 包含 一 个 double, 





可 使 用 下 列 方法 。 


string str = "12.5"; 

double result = 0; 

if(double.TryParse(str, 
System.Globalization.NumberStyles.Float, 
System.Globalization.NumberFormatInfo.CurrentInfo, 
out result)) 


{ 
} 


// 是 一 个 double 


3.5.3 ”讨论 








本 范例 展示 了 如 何 确定 一 个 字符 串 是 否 只 包含 一 个 数字 值 。 如 果 字 符 串 包含 一 个 有 效 数 





字 ，TryParse 方法 将 返回 true， 而 且 不 会 遇 到 使 用 Parse 方法 时 的 异常 。 


3.5.4 ”参考 
MSDN 文档 中 的 “Parse” 和 “TryParse” 主 题 。 


3.6 FARA 


3.6.1 问题 
你 需要 将 一 个 数字 舍 入 为 一 个 整数 ， 或 者 舍 入 到 指定 的 小 数 点 位 数 。 


3.6.2 ”解决 方案 





要 将 一 个 数字 舍 入 为 其 最 接近 的 整数 ， 可 使 用 静态 Math Round 方法 ， 该 方法 


参数 。 


int i = (int)Math.Round(2.5555); // i == 3 




















如 果 你 需要 将 一 个 浮 点 值 舍 人 到 指定 的 小 数 点 位 数 ， 可 使 用 重 载 的 静态 Math Round 方法 ， 


它 接受 两 个 参数 。 


double dbl = Math.Round(2.5555, 2); // dbl == 2.56 


3.6.3 ”讨论 


Round 方法 易于 使 用 ,但 是 用 户 需 要 了 解 舍 入 运算 的 工作 方式 。Round 方法 遵循 IEEE 标准 























754 的 第 4 市 标 准 ， 这 意味 着 如 果 要 舍 入 的 数字 位 于 两 个 数字 之 间 ， 那 么 Round 运算 总 舍 





入 为 偶数 。 下 面 的 示例 说 明了 这 一 标准 。 
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double dbli = Math.Round(1.5); // dbL1 == 2 
double dbl2 = Math.Round(2.5); // dbl2 == 2 


我 们 注意 到 ，1.5 IA] E A BHU Be (2)， 而 2.5 被 向 下 舍 入 到 最 接近 的 整 偶数 
(同样 是 2)。 在 使 用 Round 方法 时 要 牢记 这 一 点 。 








该 方法 被 称 为 银行 家 的 舍 入 。 之 所 以 发 明 它 是 因为 它 在 舍 入 大 量具 有 半数 的 
数字 集合 时 (例如 包含 货币 的 集合 ) 引入 的 偏差 较 小 。 








3.64 ”参考 
MSDN 文档 中 的 “Math 类 ”主题 。 


3.7 ”选择 一 种 舍 入 算法 


3.7.1 问题 


Math.Round 方法 将 会 将 值 1.5 舍 入 为 2， 但 是 使 用 该 方法 也 会 将 值 2.5 舍 入 为 2。 也 许 你 希 
望 总 是 舍 入 到 较 大 的 数字 例如， 将 2.5 舍 入 为 3 而 不 是 2)。 相 反 地 ， 你 也 许 希望 总 是 舍 
入 到 较 小 的 数字 (例如 将 1.5 舍 入 为 1)。 


3.7.2 ”解决 方案 
当 一 个 值 位 于 两 个 整数 中 间 时 ， 可 以 使 用 静态 Math Floor 方法 始终 进行 向 上 伟人 。 


public static double RoundUp(double vaLueToRound) => 
Math.Floor(valueToRound + 0.5); 


一 个 值 位 于 两 个 整数 中 间 时 ， 可 使 用 下 列 技术 始终 进行 向 下 人 铭 和 人 。 


public static double RoundDown(double valueToRound) 











Uk 





double floorValue = Math.Floor(valueToRound) ; 
if ((valueToRound - floorValue) > .5) 

return (floorValue + 1); 
else 

return (floorValue); 


} 


3.7.3 讨论 


静态 Math.Round 方法 伟人 到 最 接近 的 偶数 。 但 是 ， 有 时 并 不 希望 以 这 种 方式 售 人 数字 。 静 
A Math.Floor 方法 可 用 于 允许 不 同方 式 的 含 人 。 
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本 范例 中 用 于 舍 入 数字 的 方法 不 舍 入 到 指定 小 数 点 位 数 ， 而 是 舍 入 到 最 接近 
的 整数 。 


3.74 ”参考 
MSDN 文档 中 的 “Math 类 ”主题 。 


3.8 ”安全 地 执行 窄 化 数据 转换 


3.8.1 问题 

用 户 需要 将 一 个 较 大 的 值 转换 为 一 个 较 小 的 值 ， 同 时 优雅 地 处 理 转换 导致 的 信息 丢失 。 例 
如 ， 仅 当 long 数据 类 型 大 于 int.MaxSize 时 ， 将 一 个 long 转换 为 一 个 int 才 会 导致 信息 
BR, 


3.8.2 ”解决 方案 
完成 这 一 检查 最 简单 的 方法 是 使 用 checked 关键 字 。 下 列 扩展 方法 接受 两 个 Long 数据 类 
型 ， 并 且 试图 将 它们 相 加 。 结 果 被 放 和 人 一 个 int 数据 类 型 。 如 果 存 在 一 个 溢出 状况 ， 那 么 


会 引发 一 个 OverflowException, 














public static class DataTypeExtMethods 


{ 
public static int AddNarrowingChecked(this long lhs, long rhs) => 


checked((int)(lhs + rhs)); 
} 


// 使 用 了 扩展 方法 的 代码 
long Lhs = 34000; 
long rhs = long.MaxValue; 
try 
{ 
int result = lhs.AddNarrowingChecked(rhs); 


catch(OverflowException) 


// 不 能 加 到 一 起 

















这 是 最 简单 的 方法 。 如 果 不 希望 有 引发 异常 的 开销 并 且 不 希望 必须 将 大 量 代码 封装 到 try- 
catch 语句 块 中 处 理 溢出 状况 ， 那 么 可 以 使 用 每 种 类 型 的 MaxValue 和 MinValue 字段 。 使 用 
这 些 字段 的 检查 可 在 转换 之 前 进行 ， 以 确保 不 会 发 生 信息 丢失 。 如 果 转 换 将 会 导致 信息 丢 
失 ， 代 码 可 以 提前 通知 应 用 程序 。 可 以 使 用 下 列 条 件 语句 确定 sourceValue 是 否 能 被 转换 
成 一 个 short 而 不 会 丢失 任何 信息 。 

















A 
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// 两 个 变量 被 声明 和 初始 化 
int sourceValue = 34000; 
short destinationValue = 0; 





// 确定 sourceValue 被 转换 成 一 个 short 时 是 否 会 丢失 任何 信息 : 

if (sourceValue <= short.MaxValue && sourceValue >= short.MinValue) 
destinationValue = (short)sourceValue; 

else 








// 通知 应 用 程序 将 会 发 生 信息 丢失 





3.8.3 讨论 

窜 化 转换 (narrowing conversion) 发 生 在 将 一 个 较 大 类 型 转换 成 一 个 较 小 类 型 时 。 例 如 ， 
考虑 将 一 个 Int32 类 型 的 值 转换 为 一 个 Int16 类 型 的 值 。 如 果 Int32 值 小 于 或 等 于 Int16. 
MaxValue 字段 并 且 Int32 值 大 于 或 等 于 Int16.MinValue 字段 ， 那 么 转换 进行 时 不 会 出 现 
错误 或 信息 丢失 。 信 息 丢 失 发 生 在 当 Int32 值 大 于 Int16.MaxValue 字段 或 者 Int32 值 小 于 
Inti6.MinValue 字段 的 时 候 。 在 这 两 种 情况 下 ，Int32 最 重要 的 位 被 截 去 并 丢弃 ， 转 换 后 
值 发 生 了 变化 。 


如 果 信 息 丢失 发 生 在 未 检查 的 上 下 文中 ， 它 将 悄悄 地 发 生 而 不 会 通知 应 用 程序 。 该 问题 可 
能 导致 某 些 非常 有 害 且 难 以 跟踪 的 错误 。 为 了 防止 这 一 错误 ， 检 查 要 转换 的 值 ， 确 定 它 是 
否 位 于 将 要 转换 到 的 类 型 下 限 和 上 限 范围 内 。 如 果 值 超出 了 这 些 范 围 ， 那 么 可 以 编写 代码 
处 理 这 种 情况 。 该 代码 可 以 防止 转换 发 生 和 /或 通知 应 用 程序 转换 问题 。 该 解决 方案 有 助 
于 防止 难以 查找 的 算法 错误 悄悄 进入 用 户 应 用 程序 。 

3.82 市 中 所 示 的 两 种 技术 都 是 有 效 的 。 尽 管 如 此 ， 具 体 使 用 哪 种 技术 将 取决 于 预期 是 经 常 
性 地 还 是 仅仅 偶然 地 遇 到 溢出 情况 。 如 果 预 期 经 常 遇 到 洪 出 情况 ， 你 也 许 会 想 选 择 第 二 种 
手动 测试 数值 的 技术 ， 否 则 使 用 第 一 种 技术 中 的 checked 关键 字 会 比较 容易 。 


在 C# 中 ， 代 码 可 以 在 已 检查 (checked) 或 未 检查 (unchecked) Hy E Fx 
中 和 运行。 默认 情况 下 ， 代 码 会 在 未 检查 的 上 下 文中 运行 。 在 已 检查 的 上 下 文 
中 ， 任 何 涉及 整数 类 型 的 算法 和 转换 都 会 经 过 检查 ， 以 确定 是 否 存在 溢出 状 
况 。 如 果 存 在 ， 则 会 引发 一 个 0verflowException。 在 未 检查 的 上 下 文 名 ， 当 
溢出 状况 存在 时 不 会 引发 OverflowException, 

通过 使 用 /checked{+} 编译 器 开关 将 Check for Arithmetic Overflow/Underflow 
项 目 属性 设置 为 true， 或 者 通过 使 用 checked 关键 字 ， 可 以 建立 一 个 已 检查 
的 上 下 文 。 通 过 使 用 /checked- 编译 器 开关 将 Check for Arithmetic Overflow/ 
Underflow 项 目 属性 设置 为 false， 或 者 通过 使 用 unchecked 关键 字 ， 可 以 建 
立 一 个 未 检查 的 上 下 文 。 







































































在 执行 转换 时 应 当知 道 下 列 内 容 。 
。 将 一 个 float、double 或 decimal 转换 成 一 个 整数 类 型 会 导致 数值 的 小 数 部 分 被 截 掉 。 此外， 
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如 果 数 值 的 整数 部 分 超过 了 目标 类 型 的 MaxvaLue， 那 么 结果 将 会 变 得 未 定义 ， 除 非 转换 
在 一 种 已 检查 的 上 下 文中 进行 ， 在 这 种 情况 下 ， 它 会 触发 一 个 OverfLowException。 

。 将 一 个 float 或 double 强制 转换 成 一 个 decimal 会 导致 float 或 double 被 含 人 到 28 位 
小 数 点 。 

。 将 一 个 double 强制 转换 成 一 个 float 会 导致 double 被 舍 入 到 最 接近 的 浮 点 值 。 
。 将 一 个 decimal 转换 成 一 个 float 或 double 会 导致 decimat 被 含 人 为 结果 类 型 (float 
或 double), 

。 将 一 个 int、uint 或 long 转换 成 一 个 float 可 能 导致 精度 丢失 ， 但 不 会 改变 量 级 。 

。 将 一 个 long 转换 为 一 个 double 可 能 会 导致 精度 丢失 ， 但 不 会 改变 量 级 。 





























3.84 参考 


MSDN 文档 中 的 “checked KHER” “Checked 和 Unchecked” 主 题 。 


3.9 测试 有 效 的 枚 举 值 


3.9.1 问题 


当 疝 一 个 接收 枚 举 值 的 方法 传递 一 个 数字 值 时 ， 很 可 能 会 传递 一 个 枚 举 中 不 存在 的 值 。 你 
希望 在 使 用 该 枚 举 值 之 前 执行 测试 ， 确 定 它 是 否 确实 是 该 枚 举 类 型 中 定义 的 项 。 


3.9.2 ”解决 方案 

为 了 防止 这 一 问题 发 生 ， 可 使 用 一 个 switch 语句 列 出 有 效 值 ， 测 试用 户 允 许 用 于 枚 举 类 型 
参数 的 特定 枚 举 值 。 
使 用 下 列 Language 枚 举 。 


public enum Language 

{ 
Other = 0, CSharp = 1, VBNET = 2, VB6 = 3, 
ALL = (Other | CSharp | VBNET | VB6) 

} 


假设 有 一 个 接收 Language 枚 举 的 方法 ， 例 如 下 列 方法 。 


public void HandleEnum(Language language) 
































// 此 处 使 用 Language TP 


你 需要 一 个 方法 ， 定 义 可 在 HandleEnum 中 接受 的 枚 举 值 。 下 面 所 示 的 CheckLanguageEnumValue 
方法 可 完成 这 项 工作 。 
public static bool CheckLanguageEnumValue(Language language) 


{ 
switch (language) 


{ 
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// 列 出 枚 举 的 所 有 有 效 类 型 
// 这 意味 着 仅 指定 的 项 是 有 效 的 
// 而 不 是 该 枚 举 的 所 有 枚 举 值 
case Language.CSharp: 
case Language.Other: 
case Language.VB6: 
case Language.VBNET: 
break; 
default: 
Debug.Assert(false, 
$'(language) is not a valid enumeration value to pass."); 
return false; 


j 


return true; 


} 


3.9.3 讨论 

尽管 Enum 类 包含 静态 IsDefined 方法 ， 但 不 应 当 使 用 它 。IsDefined 内 部 使 用 反射 ， 它 会 
导致 性 能 损失 。 同 样 ， 枚 举 的 版 本 化 未 能 得 到 很 好 的 处 理 。 考 虑 在 软件 的 下 一 版 本 中 将 值 
ManagedCPLusPLus 添加 到 Language 枚 举 中 的 情况 。 如 果 IsDefined 被 用 于 检查 此 处 的 参 
数 ， 那 么 它 将 允许 MgdCpp 作为 一 个 合法 值 ， 因 为 它 在 枚 举 中 定义 了 ， 尽 管用 于 验证 参数 
的 代码 未 被 设计 用 于 处 理 它 。 通 过 明确 使 用 CheckLanguageEnunValue 中 所 示 的 switch 语 
名 ， 将 会 拒绝 MgdCpp 值 ， 而 代码 不 会 试图 在 一 个 无 效 的 环境 下 运行 ， 因 为 这 毕竟 是 用 户 
首要 追求 的 。 

在 方法 对 外 部 对 象 可 见 的 情况 下 ， 应 当 始 终 进行 枚 举 检查 。 一 个 外 部 对 象 可 以 调用 带 有 公 
共 可 见 性 的 方法 ， 因 此 ， 任 意 传 入 该 方法 的 枚 举 值 都 应 当 在 其 实际 使 用 之 前 进行 筛选 。 

带 有 私有 可 见 性 的 方法 可 能 不 需要 这 种 额外 的 保护 级 别 。 使 用 你 自己 的 判断 来 决定 是 否 使 
用 CheckLanguageEnumValue 方法 去 评估 传递 给 私有 方法 的 枚 举 值 。 

HandleEnum 方法 能 够 以 若干 不 同 的 方式 进行 调用 ， 其 中 两 种 如 下 所 示 。 


HandleEnum(Language.CSharp); 
HandleEnum((Language)1); // 1 是 CSharp 


任意 一 种 方法 调用 都 是 合法 的 。 不 幸 的 是 ， 下 面 的 方法 调用 也 是 合法 的 。 


HandleEnum((Language)100); 
int someVar - 42; 
HandleEnum((Language)someVar) ; 


这 些 方 法 调用 也 能 无 错误 地 通过 编译 ， 但 是 如 果 HandleEnum 中 的 代码 试图 使 用 传递 给 它 的 
值 (在 这 种 情况 下 ， 值 为 199)， 那 么 将 会 发 生 古 怪 的 行为 。 在 许多 情况 下 ， 其 至 不 会 引发 
异常 ，HandleEnun 仅仅 是 接受 值 100 作为 参数 ， 就 如 同 它 是 Language 枚 举 的 合法 值 一 样 。 
CheckLanguageEnumValue 方法 通过 筛选 参数 找 出 有 效 的 Language 枚 举 值 来 防止 这 种 情况 的 
发 生 。 下 列 代码 给 出 HandleEnun 方法 修改 后 的 方法 体 。 


public static void HandleEnum(Language language) 


( 


















































à 














7 
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if (CheckLanguageEnumValue( Language) ) 


// 此 处 使 用 Language 


Console.WriteLine($"{Language} is an OK enum value"); 








} 
else 
{ 
// 此 处 处 理 无 效 的 枚 举 值 
Console.WriteLine($"{Language} is not an OK enum value"); 
} 


} 


3.10 在 位 掩 码 中 使 用 枚 举 成员 


3.10.1 问题 





你 需要 一 个 枚 举 ， 其 值 可 以 作为 bit 标志 参与 求 或 操作 以 创建 枚 举 中 值 (标志 ) 的 组 合 。 








3.10.2 ”解决 方案 


使 用 Flags 特性 标记 枚 举 。 





[FLags] 
public enum RecycleItems 
t 
None - 0x00, 
Glass = 0x01, 
AluminumCans - 0x02, 
MixedPaper = 0x04, 
Newspaper = 0x08 
} 








组 合 该 枚 举 的 元 素 只 要 简单 地 使 用 位 或 运算 符 (I) 即 可 ， 如 下 所 示 。 


RecycleItems items = RecycleItems.Glass | RecycleItems.Newspaper ; 





3.10.3 iit 





向 枚 举 添 加 Flags 特性 标志 着 该 枚 举 被 视 为 可 进行 或 操作 的 单独 的 位 标志 。 使 用 标志 的 枚 











举 与 使 用 常规 枚 举 类 型 没有 任何 区 别 。 要 注意 即便 枚 举 值 被 用 作 位 标志 ， 未 能 月 

















性 标记 枚 举 也 不 会 产生 异常 或 者 编译 时 错误 。 




















H Flags 特 


添加 Flags 特性 提供 了 两 个 好 处 。 第 一 ， 如 果 将 Flags 特性 置 于 一 个 枚 举 上 ， 那 么 
ToString Af] ToString("G") 方法 返回 一 个 由 逗号 分 隔 的 常量 名 所 构成 的 字符 串 。 否 则 ， 这 
两 个 方法 返回 枚 举 值 的 数字 表示 。 要 注意 ，ToString("F") 方法 返回 一 个 由 逗号 分 隔 的 常 
量 名 所 构成 的 字符 串 ， 而 不 管 该 枚 举 是 否 被 Flags 特性 所 标记 。 第 二 ， 当 你 检查 代码 并 遇 
到 一 个 枚 举 时 ， 可 以 更 好 地 确定 开发 人 员 对 该 枚 举 的 意图 。 如 果 开 发 人 员 显 式 地 将 其 定义 























为 包含 位 标志 (使 用 Flags RPE), ， 你 就 可 以 照 此 来 使 用 它 。 
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à 


带 有 Flags 特性 的 枚 举 可 被 视 为 一 个 单独 的 值 或 者 由 一 个 或 多 个 值 组 合 而 成 的 单个 枚 举 值 。 
如 果 需 要 一 次 接受 多 种 语言 ， 可 以 编写 下 列 代码 。 


RecycleItems items = RecycleItems.Glass | RecycleItems.Newspaper; 


变量 items 现在 等 于 两 个 枚 举 值 按 位 求 或 运算 后 的 值 。 这 些 值 求 或 运算 后 等 于 3， 如 下 
所 示 。 




















RecycleItems.Glass 0001 
RecycleItems.AluminumCans 0010 
ORed bit values 0011 





枚 举 值 被 转换 为 二 进 制 ， 进 行 求 或 运算 后 得 到 二 进 制 值 9011 或 者 十 进 制 值 3。 编 译 器 将 该 
值 视 为 两 个 单独 的 枚 举 值 (RecycleItems.Glass 和 RecycleItems.AluminumCans) 求 或 运算 
组 合 在 一 起 或 是 一 个 单独 的 值 (3)。 


为 了 确定 是 否 在 一 个 枚 举 变量 上 打开 了 单个 标志 ， 可 使 用 按 位 与 (&) 运算 符 ， 如 下 所 示 。 


RecycleItems items = RecycleItems.Glass | RecycleItems.Newspaper; 
if((items & RecycleItems.Glass) == RecycleItems.Glass) 
Console.WriteLine("The enum contains the C# enumeration value"); 
else 
Console.WriteLine("The enum does NOT contain the C£ value"); 


























这 段 代 码 将 显示 文本 “The enum contains the C£ enumeration value”。 如 果 变 量 items REL 

含 值 RecycleItems.Glass， 那 么 对 这 两 个 值 求 与 运算 将 产生 06。 如 果 itens 包含 该 枚 举 值 ， 

那么 将 产生 值 RecyctLeItems.GLass。 实 质 上 ， 以 二 进 制 格式 对 这 两 个 值 求 与 运算 如 下 所 示 。 
RecycleItems.Glass | RecycleItems.AluminumCans 0011 


RecycleItems.Glass 0001 
ANDed bit values 0001 


我 们 将 在 范例 3.11 (BN 3.11 75). 中 详细 处 理 这 一 主题 。 


在 某 些 情况 下 ， 枚 举 可 能 变 得 相当 大 。 可 以 向 该 枚 举 中 添加 许多 其 他 可 重复 使 用 的 数据 
项 ， 如 下 所 示 。 























ss 











[Flags] 

public enum RecycleItems 

{ 
None = 0x00, 
Glass = 0x01, 
AluminumCans = 0x02, 
MixedPaper = 0x04, 
Newspaper = 0x08, 
TinCans = 0x10, 
Cardboard = 0x20, 
ClearPlastic = 0x40, 

} 


当 需 要 一 个 RecycteItems 枚 举 值 来 表示 所 有 可 重复 使 用 的 项 时 ， 用 户 必须 对 该 枚 举 中 的 所 
有 值 进行 求 或 运算 。 
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RecycleItems items = RecycleItems.Glass | RecycleItems.AluminumCans | 
RecycleItems.MixedPaper; 


如 果 不 这 样 做 ， 你 也 可 以 简单 地 向 枚 举 中 添加 一 个 包含 所 有 可 重复 使 用 项 的 新 值 。 


[FLags] 

public enum RecycleItems 

t 
None - 0x00, 
Glass = 0x01, 
AluminumCans = 0x02, 
MixedPaper = 0x04, 
Newspaper - 0x08, 
TinCans - 0x10, 
Cardboard = 0x20, 
ClearPlastic = 0x40, 


All = (None | Glass | AluminumCans | MixedPaper | Newspaper | TinCans | 
Cardboard | ClearPlastic) 


} 


现在 已 有 了 一 个 单独 的 枚 举 值 ALL， 它 包含 着 该 枚 举 的 所 有 值 。 要 注意 ， 生 成 ALL 枚 举 值 
有 两 种 方法 。 第 二 种 方法 更 容易 阅读 。 不 管 使 用 哪 种 方法 ， 如 果 添 加 或 删除 了 枚 举 中 的 单 
个 语言 元 素 ， 那 么 就 必须 相应 地 修改 ALL fL, 


应 当 为 所 有 枚 举 提供 一 个 None 值 ， 即 便 在 “以 上 皆 非 ”没有 意义 的 情况 下 也 
是 如 此 ， 因 为 将 字面 量 9 赋 给 一 个 枚 举 总 是 合法 的 ， 而 且 因 为 枚 举 变量 被 赋 
FERAE 0 开始 它 的 整个 生命 期 。 




















同样 ， 也 可 以 添加 值 来 捕获 枚 举 值 的 特定 子 集 ， 如 下 所 示 。 


[Flags] 
enum Language 


{ 








CSharp = 0x0001, VBNET = 0x0002, VB6 = 0x0004, Cpp = 0x0008, 
CobolNET = 0x000F, FortranNET = 0x0010, JSharp = 0x0020, 
MSIL - 0x0080, 
All = (CSharp | VBNET | VB6 | Cpp | FortranNET | JSharp | MSIL), 
VBOnly - (VBNET | VB6), 
NonVB - (CSharp | Cpp | FortranNET | JSharp | MSIL) 

} 


现在 ， 该 枚 举 中 拥有 了 两 个 额外 成 员 ， 一 个 仅 包 含 VB 语言 (Languages.VBNET 和 
Languages.VB6)， 男 一 个 包含 非 VB 语言 。 


3.11 确定 是 否 设 置 了 一 个 或 多 个 枚 举 标志 


3.11.1 问题 
你 需要 确定 一 个 由 位 标志 构成 的 枚 举 类 型 变量 是 否 包含 一 个 或 多 个 特定 标志 。 例 如 ， 给 定 
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下 列 枚 举 Language, 
[Flags] 
enum Language 
{ 
} 


使 用 布尔 逻辑 判定 下 列 代 码 行 中 的 变量 Lang 是 否 包 含 Language.CSharp 和 /或 Language. 
Cpp 之 类 的 语言 。 


Language lang = Language.CSharp | Language.VBNET; 


3.11.2 ”解决 方案 
要 确定 一 个 变量 是 否 包 含 已 设置 的 单个 位 标志 ， 可 使 用 下 列 条 件 语句 。 


if((lang & Language.CSharp) == Language.CSharp) 


CSharp = 0x0001, VBNET = 0x0002, VB6 = 0x0004, Cpp = 0x0008 














// Vang /b &Y& f Language. CSharp 
} 


要 确定 一 个 变量 是 否 仅 包 含 已 设置 的 单个 位 标志 ， 可 使 用 下 列 条 件 语 句 。 


if(lang == Language.CSharp) 














// Lang 仅 包含 Language.CSharp 
} 


要 确定 一 个 变量 是 否 包 含 已 设置 的 一 个 位 标志 集合 ， 可 使 用 下 列 条 件 语句 。 


if((lang & (Language.CSharp | Language.VBNET) 
(Language.CSharp | Language. VBNET)) 
{ 


} 
要 确定 一 个 变量 是 否 只 包含 已 设置 的 一 个 位 标志 集合 ， 可 使 用 下 列 条 件 语句 。 


if((lang | (Language.CSharp | Language.VBNET)) == 
(Language.CSharp | Language.VBNET) ) 
{ 


} 


3.11.3 讨论 


当 把 枚 举 用 作 位 标志 并 且 用 Flags 特性 进行 标记 时 ， 它 们 通常 会 需要 执行 某 种 类 型 的 条 件 
测试 。 这 些 测试 使 位 与 运算 符 (8) 和 或 运算 符 CI) 成 为 必需 。 


要 测试 一 个 变量 是 否 设置 了 一 个 特定 的 位 标志 ， 可 使 用 下 列 条 件 语句 来 完成 。 


if((lang & Language.CSharp) == Language.CSharp) 














// lang 至 少 包含 了 Language.CSharp 和 Language.VBNET 








// Lang 仅 包含 了 Language.CSharp 和 Language.VBNET 
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其 中 ，Lang Language 枚 举 类 型 。 

& 运算 符 使 用 一 个 位 撩 码 来 确定 某 个 位 是 否 被 设置 为 1。 仅 当 同时 为 1 时 ， 对 两 个 位 求 
与 运算 的 结果 才 是 1;， 否则 结果 为 96。 可 以 使 用 该 运算 符 确定 在 包含 独立 位 标志 的 数字 
中 ， 某 个 特定 位 标志 是 否 被 设置 为 1。 如 果 对 变量 lang 和 要 测试 的 特定 位 标志 (此 处 是 
Language.CSharp) 求 与 运算 ， 那 么 用 户 可 以 提取 该 特定 位 标志 。 如 果 lang 等 于 Language. 
CSharp， 那 么 表达 式 (lang & Language.CSharp) 将 以 下 列 方式 求解 。 

Language.CSharp 0001 


lang 0001 
Anded bit values 0001 


如 果 lang 等 于 其 他 值 ， 例 如 Language.VBNET， 那 么 表达 式 以 下 列 方式 求解 。 


Language.CSharp 0001 
lang 0010 
Anded bit values 0000 


我 们 注意 到 ， 对 位 求 与 在 第 一 个 表达 式 中 返回 值 Language.CSharp， 在 第 二 个 表达 式 中 返回 
gx0000。 通 过 将 该 结果 与 待 查找 的 值 (Language.CSharp) 相 比 较 ， 可 以 看 出 该 特定 位 是 否 
已 打开 。 
该 方法 对 于 检查 特定 位 非常 好 用 ， 但 是 如 果 希 望 知道 是 否 仅 有 一 个 特定 位 被 打开 (而 所 有 
其 他 位 都 被 关闭 ) 或 关闭 〈 而 所 有 其 他 位 都 被 打开 )， 该 怎么 办 呢 ? 要 测试 lang 变量 是 否 
只 有 Language.CSharp 位 被 打开 ， 可 以 使 用 下 列 条 件 语 句 。 

if(lang == Language.CSharp) 


如 果 变 量 lang 仅 包含 值 Language.CSharp， 使 用 或 运算 符 的 表达 式 将 如 下 所 示 。 


lang = Language.CSharp; 
if ((lang != 0) &&(Language.CSharp == (lang | Language.CSharp))) 

























































































|] 使 用 或 逻辑 找到 了 CSharp 


Language.CSharp 0001 
lang 0001 
ORed bit values 0001 


现在 ， 问 变量 Lang 添加 一 种 或 两 种 语言 并 对 Lang 执行 相同 的 操作 。 


lang = Language.CSharp | Language.VB6 | Language.Cpp; 
if ((lang != 0) &&(Language.CSharp == (lang | Language.CSharp))) 





|] 使 用 或 逻辑 找到 了 CSharp 


Language.CSharp 0001 
lang 1101 
ORed bit values 1101 


第 一 个 表达 式 的 结果 值 与 你 正在 测试 的 相同 。 第 二 个 表达 式 的 结果 值 大 大 超过 了 



































fe 
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Language.CSharp。 这 说 明 ， 第 一 个 表达 式 的 变量 lang 仅 包 含 值 Language.CSharp， 而 第 
二 个 表达 式 除 了 Language.CSharp 外 还 包含 其 他 语言 (也 可 能 根本 没有 包含 Language. 
CSharp), 
使 用 该 公式 的 或 版 本 ， 用 户 可 以 测试 多 个 位 ， 以 确定 它们 是 否 都 被 打开 并 且 所 有 其 他 位 都 
被 关闭 ， 如 下 列 条 件 语句 所 示 。 
if((lang != 0) && ((lang | (Language.CSharp | Language.VBNET)) == 
(Language.CSharp | Language.VBNET))) 
注意 ， 为 了 测试 多 种 语言 ， 可 以 简单 地 对 语言 值 求 或 运算 。 通 过 将 第 一 个 | 运算 符 转换 为 
& 运算 符 ， 可 以 确定 是 否 至 少 有 这 些 位 被 打开 ， 如 下 列 条 件 语句 所 示 。 
if((lang != 0) && ((lang & (Language.CSharp | Language.VBNET)) == 
(Language.CSharp | Language.VBNET))) 
当 测 试 多 个 枚 举 值 时 ， 将 想 要 测试 的 所 有 值 求 或 运算 的 结果 值 添加 到 枚 举 中 会 带 来 一 些 好 
处 。 如 果 和 希望 测试 除 Language.CSharp 之 外 的 所 有 其 他 语言 ， 那 么 条 件 语句 就 会 变 得 相当 
巨大 且 难 以 处 理 。 为 了 解决 这 一 问题 ， 可 以 向 Language 枚 举 添 加 一 个 值 ， 对 除 Language. 
CSharp 外 的 所 有 语言 求 或 运算 。 新 枚 举 如 下 所 示 。 
[Flags] 


enum Language 


( 


















































CSharp - 0x0001, VBNET - 0x0002, VB6 - 0x0004, Cpp - 0x0008, 
AlllanguagesExceptCSharp - VBNET | VB6 | Cpp 
} 


条 件 语句 可 能 如 下 所 示 。 


if((lang != 0) && (lang | Language.AllLanguagesExceptCSharp) == 
Language. AllLanguagesExceptCSharp) 


这 相对 短小 一 些 ， 更 易于 管理 和 阅读 。 


在 测试 一 个 或 多 个 位 是 否 被 设置 为 1 时 使 用 与 运算 符 。 在 测试 一 个 或 多 个 位 
是 否 被 设置 为 6 时 使 用 或 运算 符 。 
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第 4 章 


语言 集成 查询 和 lambda 表 达 式 





4.0 简介 


语言 集成 查询 (language integrated query，LINQ) 是 访问 许多 不 同 来 源 数据 的 卓越 方式 。 
LINQ 提供 了 一 种 可 以 在 单个 查询 中 分 别 或 者 同时 操作 不 同 数据 领域 的 单一 查询 模型 。 
LINQ 为 .NET 语言 ?3 入 了 查询 数据 的 能 力 ， 并 且 其 中 一 些 语言 己 经 提供 了 扩展 ， 使 得 它 的 
使 用 更 为 直观 ， 其 中 一 种 语言 就 是 Ch, E C# 中 有 许多 对 该 语言 的 扩展 ， 有 助 于 以 一 种 功 
能 丰富 、 直 观 的 方式 为 查询 提供 便利 。 


传统 的 面向 对 象 编程 基于 一 种 命令 式 (imperative) 风格 。 在 这 种 风格 下 ， 开 发 人 员 不仅 要 
详细 描述 他 们 希望 发 生 什 么 事情 ， 还 要 详细 准确 描述 如 何 通过 代码 来 执行 。LINQ 有 助 于 
使 代码 更 具 声明 性 (declarative) ， 从 而 便于 开发 人 员 描 述 他们 想 要 做 什么 ， 而 不 用 详 述 如 
何 达 到 目标 。LINQ 还 支持 更 函数 式 的 编程 风格 。 这 些 变 化 可 以 显著 减少 执行 某 些 任 务 所 
需 的 代码 量 。 也 就 是 说 ， 面 向 对 象 编程 在 Ct 和 .NET 中 仍然 具有 强大 的 生命 力 ， 但 是 CH 
语言 第 一 次 提供 了 一 种 机 会 ， 让 你 根据 自己 的 需要 选择 编程 风格 。 不 过 要 注意 的 是 ，LINQ 
并 不 是 对 各 种 情况 都 适用 ， 也 不 能 代替 良好 的 设计 或 实践 。 使 用 LINQ 也 可 能 编写 出 糟糕 
的 代码 ， 就 如 同 可 能 编写 出 糟糕 的 面向 对 象 或 过 程式 代码 一 样 。 这 其 中 的 难点 一 直 都 在 于 
清楚 什么 时 候 适 合 使 用 哪 种 技术 。 


LINQ 的 初始 版 本 包含 许多 数据 领域 ， 如 下 所 示 。 


。 LINQ to Object 

。 LINQto XML 

。 LINQ to ADO.NET 
。 LINQ to SQL 

。 LINQ to DataSet 
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。 LINQ to Entity 


当 你 刚 开始 学 习 LINQ 时 ， 很 容易 把 它 看 成 一 个 新 的 对 象 关 系 映射 层 、IEnumerable<T> 上 
灵巧 的 新 构件 、 一 个 新 的 XML API 甚至 只 是 不 用 再 直接 编写 SQL 语句 的 一 个 借口 。 你 可 
以 把 LINQ 当 作 这 些 来 使 用 ,但 是 我 们 鼓励 你 把 LINQ 视 为 应 用 程序 如 何 请 求 、 计 算 或 转 
换 来 自 单一 源 和 不 同 源 的 数据 集 。 需 要 花 一 点 时 间 来 熟悉 LINQ 的 功能 ， 但 是 一 旦 走 过 这 
一 步 ， 你 就 会 对 自己 能 够 用 它 所 做 的 事情 感到 吃惊 。 本 章 首 先 将 介绍 可 以 利用 LINQ 做 什 
么 ， 并 且 和 希望 引导 你 考虑 自己 的 哪些 情况 适合 使 用 C# 中 的 这 种 新 能 力 。 
为 了 编写 LINQ 查询 表达 式 以 指定 条 件 和 选择 数据 ， 我 们 使 用 lambda 表达 式 。 它 们 是 表 
示 传 递 给 LINQ 查询 的 委托 的 一 种 简便 方式 。 例 如 ， 为 了 缩小 结果 集 而 调用 Enumerable. 
Where 方法 时 传 入 的 System.Func<T, TResult» 委托 。lambda 表达 式 是 具有 不 同 语法 的 国 
数 ， 这 人 允许 它们 用 于 表达 式 上 下 文中 ， 代 替 通 常 作为 类 成 员 的 面向 对 象 的 方法 。 这 意味 着 
利用 一 种 语法 ， 就 可 以 表达 方法 定义 、 声 明 以 及 调用 委托 来 执行 它 ， 就 像 匿 名 方法 可 以 
做 到 的 那样 ， 但 它 的 语法 更 简洁 。 投 影 (projection) 是 把 一 种 类 型 转换 成 另 一 种 类 型 的 
lambda 表达 式 。 
lambda 表达 式 如 下 所 示 。 

j => j * 42 
这 意味 着 “把 j 用 作 国 数 的 参数 ，j 最 终 对 应 j*42 这 个 结果 ”。 对 于 这 个 表达 式 以 及 像 下 
面 这 样 声 明 的 投影 来 说 ， 可 以 把 => 读 作 “对 应 于 ”。 


j => new { Number = j*42 }; 
回想 一 下 ， 在 C# 1.0 中 可 以 做 同样 的 事 : 


public delegate int IncreaseByANumber(int j); 
public delegate int MultipleIncreaseByANumber(int j, int k, int 1); 

































































ES 
Ho 








static public int MultiplyByANumber(int j) 
{ 


} 


return j * 42; 


public static void ExecuteCSharp1_0() 


{ 
IncreaseByANumber increase = 
new IncreaseByANumber ( 
DelegatesEventsLambdaExpressions.MultiplyByANumber); 
Console.WriteLine(increase(10)); 
} 











在 C# 2.0 中 ， 利 用 匿名 方法 可 以 把 CH 1.0 的 语法 简化 为 以 下 示例 ， 因 为 不 再 需要 提供 委托 
的 名 称 ， 而 且 我 们 只 想 要 运算 的 结果 。 


public delegate int IncreaseByANumber(int j); 














public static void ExecuteCSharp2_0() 
{ 
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} 


IncreaseByANumber increase = 
new IncreaseByANumber ( 
delegate(int j) 


return j * 42; 


p; 


Console.WriteLine(increase(10)); 





这 把 我 们 带 回 到 现在 的 CH 和 lambda 表达 式 ， 如 今 我 们 只 需 编 写 如 下 代码 。 


public static void ExecuteCSharp6_0() 


{ 


} 








// 声明 Lambda 表 达 式 
IncreaseByANumber increase = j => j * 42; 
// 调用 方法 并 在 控制 台 上 输出 420 


Console.WriteLine(increase(10)); 








MultipleIncreaseByANumber multiple = (j, k, l) => ((j * 42) / k) %1; 
Console.WriteLine(multiple(10, 11, 12)); 





类 型 推断 可 以 帮助 编译 器 从 IncreaseByANumber 委托 类 型 的 声明 推断 3 的 类 型 。 如 果 有 多 
个 参数 ， 那 么 lambda 表达 式 将 如 下 所 示 。 


MultipleIncreaseByANumber multiple = (j, k, 1) => ((j * 42) / k) %1; 
Console.WriteLine(multiple(10, 11, 12)); 


本 章 中 的 范例 利用 了 委托 、 事 件 和 lambda 表达 式 。 在 其 他 主题 中 ， 这 些 范 例 涵盖 了 以 下 


内 容 。 


。 单独 


























FE 处 理 在 多 播 委托 中 调用 的 每 个 方法 
。 同步 委托 调用 和 异步 委托 调用 











。 利用 事件 增强 现 有 的 类 

* lambda 表达 式 、 闭 包 和 函数 对 象 的 多 种 用 法 

如 有 果 你 不 熟悉 委托 、 事 件 或 lambda 表达 式 ， 就 应 该 阅读 一 下 关于 这 些 主题 的 MSDN 文档 。 
还 有 一 些 很 好 的 教程 和 示例 代码 ， 说 明了 如 何以 基本 的 方式 建立 和 使 用 它们 。 


4.1 


4.1.1 


你 希望 能 够 以 特定 的 条 件 从 现 有 消息 队列 中 查询 消息 。 











查询 消息 队列 


问题 


4.1.2 解决 方案 


使 用 EnumerableMessageQueue 类 编写 一 个 LINQ 查询 ， 使 用 System.Messaging.MessageQueue 








类 型 检索 消息 。 
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string queuePath = @".\private$\LINQMQ"; 
EnumerableMessageQueue messageQueue = null; 
if (!EnumerableMessageQueue.Exists(queuePath) ) 

messageQueue = EnumerableMessageQueue.Create(queuePath); 
else 

messageQueue = new EnumerableMessageQueue(queuePath) ; 


using (messageQueue) 


( 


BinaryMessageFormatter messageFormatter - new BinaryMessageFormatter(); 









































// 使 用 下 列 条 件 来 查询 消息 队列 中 的 特定 消息 
// 1) label 必 须 小 于 5 
// 2) 消息 体 中 的 类 型 名 称 必须 包含 CSharpRecipes.D 
// 3) 结果 需要 使 用 类 型 名 称 (消息 体 中 的 ) 降 序 排序 


















































var query = from Message msg in messageQueue 


// 对 msg.Formatter 的 首次 赋值 是 为 了 能 够 访问 Message 对 象 




















// 这 一 操作 将 BinaryMessageFormatter 赋 给 了 每 个 消息 实例 ， 














// 以 便于 读 取 它 以 确定 是 否 符合 条 件 














// 完成 赋值 操作 后 ,通过 执行 相等 检查 以 检查 格式 化 器 是 否 被 正确 赋值 ， 





// 该 相等 检查 符合 where 语 句 要 求 的 gooLean 结 果 ， 
// 同时 仍然 执行 格式 化 器 的 赋值 操作 








where ((msg.Formatter = messageFormatter) == messageFormatter) && 


int.Parse(msg.Label) < 5 && 


msg.Body.ToString().Contains("CSharpRecipes.D") 


orderby msg.Body.ToString() descending 
select msg; 


// 检查 结果 ,查看 LabetL < 5 并 且 在 名 称 中 包含 CSharpRecipes.D 
foreach (var msg in query) 
Console.WriteLine($"Label: {msg.Label}" + 
$" Body: {msg.Body}"); 





} 


查询 从 MessageQueue 中 检索 数据 ， 通 过 如 下 条 件 选 择 消 息 : ies 
个 小 于 5 的 数字 ， 并 且 消 息 体 中 包含 文本 CSharpRecipes.D。 然 后 返 
体 以 降序 对 它们 进行 排序 。 


4.1.3 讨论 




















e var 


"HE Arh, Label 是 一 





这 些 消 息 ， 并 按 消息 


在 这 段 使 用 LINQ 的 代码 中 有 下 面 这 些 关 键 字 ， 之 前 没有 用 于 访问 消息 队列 。 


指示 编译 器 通过 语句 的 右边 推断 变量 的 类 型 。 实 质 上 ， 变 量 的 类 型 是 由 隔 开 var 关键 字 
与 表达 式 之 间 的 运算 符 右边 的 内 容 确 定 的 。 这 允许 隐 式 类 型 化 的 局 部 变量 。 





e from 








fron 关键 字 指定 要 查询 的 源 集合 ， 并 创建 一 个 范围 变量 来 表示 该 集合 中 的 单个 元 素 。 
它 总 是 查询 操作 中 的 第 一 个 子 句 。 如 果 你 习惯 于 使 用 SQL 并 且 期 望 首先 看 到 select, 
这 可 能 是 违反 直觉 的 ， 但 是 考虑 到 首先 需要 明确 操作 对 象 而 不 是 确定 要 返回 什么 ， 那 么 
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lin. 





这 就 是 有 意义 的 。 
有 些 违反 直觉 。 

e where 
where Jc &E^E HT HRAEZIRARTE, eh Ee SER ITCRA ET ie. FES RE 
值 结 果 必 须 是 一 个 Boolean 值 ， 当 所 有 表达 式 都 求 值 为 true 时 ， 就 允许 选择 集合 的 此 
元 素 。 


e orderby 


orderby 指示 应 该 根据 指定 的 条 件 对 结果 集 进行 排序 。 默 认 顺 序 是 升序 ， 并 且 元 素 使 用 
默认 的 比较 器 。 


e select 


select 允许 把 集合 中 的 整个 元 素 、 具 有 该 元 素 的 一 部 分 及 其 他 计算 值 的 新 类 型 构造 或 
者 数据 项 的 子 集合 投影 到 结果 中 。 


messageQueue 集合 是 System.Messaging.MessageQueue 类 型 ， 它 实现 了 IEnumerable 接口 。 
这 是 很 重要 的 ， 因 为 提供 的 LINQ 方法 要 求 集合 至 少 实现 IEnumerable， 以 便 使 之 处 理 这 个 
集合 。 实 现 一 组 不 需要 IEnumerable ee ee 但 是 大 多 数 人 没有 这 样 的 需求 。 
当 集 合 实现 IEnumerable<T> 时 甚至 更 好 一 些 ， 因 为 这 样 LINQ 就 会 知道 它 正 在 处 理 的 集合 
中 的 元 素 类 型 。 

即使 MessageQueue 实现 了 IEnumerable 接口 (但 没有 实现 IEnumerable<T>), IEnumerable 
的 原始 实现 有 一 些 问题 ， 所 以 现在 如 果 你 尝试 使 用 它 ， 它 实际 上 并 不 会 枚 举 任何 结果 。 如 
果 你 尝试 使 用 MessageQueue 上 的 GetEnumerator, ， 也 将 得 到 弃 用 警告 :“ 此 方法 返回 一 个 错 
误 地 实现 RemoveCurrent 方法 族 的 MessageEnumerator 对 象 。 请 使 用 GetMessageEnumerator2 
AR.” 

为 了 解决 这 个 问题 ， 我 们 创建 了 EnumerableMessageQueue， 它 从 MessageQueue 派生 ， 但 使 
用 GetMessageEnumerator2 方法 来 实现 IEnumerable 和 IEnumerabLe<Message>。 所 以 ， 我 们 
可 以 直接 使 用 MessageQueue 实例 和 LINQ。 


public class EnumerableMessageQueue : MessageQueue, IEnumerable<Message> 


{ 


EKE, AERIS SQL 的 方式 ， 那 么 SQL 的 方式 看 起 来 会 
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public EnumerableMessageQueue() : 
base() { } 

public EnumerableMessageQueue(string path) : base(path) { } 

public EnumerableMessageQueue(string path, bool sharedModeDenyReceive) : 
base (path, sharedModeDenyReceive) { } 

public EnumerableMessageQueue(string path, QueueAccessMode accessMode) : 
base (path, accessMode) { } 

public EnumerableMessageQueue(string path, bool sharedModeDenyReceive, 
bool enableCache) : base (path, sharedModeDenyReceive, enableCache) { } 

public EnumerableMessageQueue(string path, bool sharedModeDenyReceive, 
bool enableCache, QueueAccessMode accessMode) : 

base (path, sharedModeDenyReceive, enableCache, accessMode) { } 


public static new EnumerableMessageQueue Create(string path) => 
Create(path, false); 





public static new EnumerableMessageQueue Create(string path, 
bool transactional) 

































































{ 
// 直接 使 用 MessageQueue 以 确保 队列 存在 
if (!MessageQueue.Exists(path)) 
MessageQueue.Create(path, transactional); 
// 一 旦 确定 其 存在 后 ,就 创建 可 枚 举 的 队列 
return new EnumerableMessageQueue(path); 
} 
public new MessageEnumerator GetMessageEnumerator() 
{ 
throw new NotSupportedException("Please use GetEnumerator"); 
} 
public new MessageEnumerator GetMessageEnumerator2() 
{ 
throw new NotSupportedException("Please use GetEnumerator"); 
} 
IEnumerator«Message» IEnumerable<Message>.GetEnumerator() 
{ 
// 注意 ,在 .NET 3.5 中 ,你 能 够 通过 正常 的 LINQ 语 义 
// 调用 MessageQueue 上 的 "GetEnumerator" 并 使 之 工作 
// 现在 我 们 必须 调用 GetMessageEnumerator2, 因为 GetEnumerator 已 被 弃 用 
// 现在 ,我 们 使 用 EnumerableMessageQueue 来 处 理 此 问题 
MessageEnumerator messageEnumerator = base.GetMessageEnumerator2(); 
while (messageEnumerator.MoveNext()) 
{ 
yield return messageEnumerator.Current; 
} 
} 
IEnumerator IEnumerable.GetEnumerator() 
{ 
// 注意 ,在 .NET 3.5 中 ,你 能 够 通过 正常 的 LINQ 语 义 
// 调用 MessageQueue 上 的 "GetEnumerator" 并 使 之 工作 
// 现在 我 们 必须 调用 GetMessageEnumerator2, 因为 GetEnumerator 已 被 弃 用 
// 现在 ,我 们 使 用 EnumerableMessageQueue 来 处 理 此 问题 
MessageEnumerator messageEnumerator = base.GetMessageEnumerator2(); 
while (messageEnumerator.MoveNext()) 
{ 
yield return messageEnumerator.Current; 
} 
} 


} 
现在 查询 提供 了 元 素 类 型 Message， 如 同 LINQ 查询 的 from 行 所 示 。 


var query = from Message msg in messageQueue 


在 解决 方案 中 ， 己 经 使 用 BinaryFormatter 发 送 了 队列 中 的 消息 。 为 了 能 够 正确 地 查询 它 
们 ， 在 把 每 个 Message 作为 where 子 名 的 一 部 分 进行 检查 之 前 ， 必 须 设 置 其 上 的 Formatter 
属性 。 
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// 对 msg.Formatter 的 首次 赋值 是 为 了 能 够 访问 Message 对 象 
// 这 一 操作 将 BinaryMessageFormatter 赋 给 了 每 个 消息 实例 ， 
// 以 便于 读 取 它 以 确定 是 否 符合 条 件 

// 完成 赋值 操作 后 ,检查 格式 化 器 是 否 被 正确 赋值 ， 

// 通过 执行 相等 检查 以 符合 where 语 句 要 求 的 Boolean 结 果 ， 
// 同时 仍然 执行 格式 化 器 的 赋值 操作 


where ((msg.Formatter = messageFormatter) == messageFormatter) && 


在 解决 方案 代码 中 使 用 了 两 次 var 关键 字 ， 如 下 所 示 。 


var query = from Message msg in messageQueue 





foreach (var msg in query) 


第 一 次 使 用 var 意味 着 将 返回 一 个 IEnumerable<Message>， 并 被 赋予 query 变量 。 第 二 次 
使 用 var 意味 着 msg 的 类 型 是 Message， 因 为 查询 变量 是 IEnumerable«Message» 类 型 ， 并 且 
msg 变量 是 该 IEnumerable 中 的 一 个 元 素 。 


另外 值得 注意 的 是 ， 在 查询 中 执行 运算 时 ， 可 以 使 用 实际 的 C# 代码 来 确定 条 件 ， 并 且 不 
仅仅 可 以 使 用 预先 确定 的 运算 符 集合 。 在 这 个 查询 的 where 子 名 中 ，int.Parse 和 string. 
Contains 都 用 于 帮助 筛选 消息 。 


int.Parse(msg.Label) < 5 && 
msg.Body.ToString().Contains('CSharpRecipes.D') 


最 后 ， 使 用 orderby 对 结果 进行 降序 排序 。 


orderby msg.Body.ToString() descending 


414 $* 


范例 4.9 (BI 4.90 5) ; MSDN 文档 中 的 “MessageQueue 类 ”“ 隐 式 类 型 的 居 部 变量 ” "from 
关键 字 ”“where 关键 字 ”“orderby HE” Fl “select 关键 字 ” 主 题 。 


4.2 ”对 数据 使 用 集合 语义 


4.2.1 问题 
你 想 要 使 用 集合 操作 处 理 集合 ， 执 行 并 、 交 、 排 除 和 去 除 重复 项 等 操作 。 


42.2 ”解决 方案 
使 用 下 列 集合 运算 符 它们 是 作为 标准 查询 运算 符 的 一 部 分 提供 的 ) 执行 以 上 操作 。 


e Distinct 





















































IEnumerable«string» whoLoggedIn = 
dailySecurityLog.Where( 
logEntry -» logEntry.Contains("logged in")).Distinct(); 





e Union 
// 并 集 
Console.WriteLine("Employees for all projects"); 
var allProjectEmployees = projecti.Union(project2.Union(project3)); 


e Intersect 


// 交集 
Console.WriteLine("Employees on every project"); 
var everyProjectEmployees = project1.Intersect(project2.Intersect(project3)); 


e Except 


Console.WriteLine("Employees on only one project"); 
var onlyProjectEmployees - allProjectEmployees.Except(unionIntersect); 


4.2.3 讨论 


标准 查 Seis HORE: 这 个 集合 包括 用 于 执行 不 同类 型 操作 的 运 
WF, beanii, Bo. HET. ese, TAR ARE. 


标准 查询 运算 符 中 的 集合 运算 符 包 括 以 下 这 


e Distinct 





* Union 
e Intersect 
e Except 


Distinct 运算 符 用 于 从 将 要 处 理 的 集合 或 结果 集中 提取 所 有 的 非 重复 项 。 例 如 ， 假 定 我 们 
有 一 个 字符 串 集 合 ， 代 表 今 天 在 公用 开发 环境 中 一 台 虚 拟 机 上 的 登录 和 注销 行为 。 


string[] dailySecurityLog = { 
"Rakshit Logged in", 
"Aaron Logged in", 
"Rakshit Logged out", 
"Ken Logged in", 
"Rakshit Logged in", 
"Mahesh Logged in", 
"Jesse logged in", 
"Jason logged in", 
"Josh logged in", 
"Melissa Logged in", 
"Rakshit Logged out", 
"Mary-Ellen logged out", 
"Mahesh logged in", 
"Alex logged in", 
"Scott logged in", 
"Aaron logged out", 
"Jesse logged out", 
"Scott logged out", 
"Dave logged in", 
"Ken logged out", 
"Alex logged out", 
"Rakshit logged in", 
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"Dave logged out", 
"Josh logged out", 
"Jason logged out"); 


从 此 集合 中 ， 我 们 想 要 确定 今天 登录 到 虚拟 机 的 人 员 列 表 。 由 于 人 们 可 以 在 一 天 中 登录 
和 注销 许多 次 或 者 一 整 天 保持 登录 ， 我 们 需要 消除 重复 的 登录 条 目 。Distinct 是 Systen. 
Ling.Enumerable 类 ( 它 实 现 了 标准 查询 运算 符 ) 上 的 一 个 扩展 方法 ， 可 以 在 字符 串 数 
组 〈 它 支持 TEnumerable) 上 调用 它 ， 用 于 从 集合 中 获取 不 同 项 目的 集合 。( 有 关 扩 展 方 
法 的 更 多 信息 ， 参 见 范 例 45， 即 4.5 市 。) 要 获得 目标 集合 ， 使 用 另 一 个 标准 查询 运算 符 
where， 其 传 入 一 个 lambda 表达 式 ， 用 于 确定 集合 的 筛选 条 件 并 检查 IEnumerabLe<string> 
中 的 每 个 字符 串 ， 以 确定 字符 串 是 否 包含 “logged in”, lambda 表达 式 是 内 联 语句 (类似 
于 匿名 方法 )， 可 用 于 代替 委托 。( 有 关 lambda 表达 式 的 更 多 信息 ， 参 见 范例 4.12， 即 
4.12 节 。) 如 果 字 符 串 包含 “logged in”, WEN]. Distinct 进一步 缩小 了 字符 串 集合 
的 范围 ， 消 除了 重复 的 “logged in” 记 录 ， 只 为 每 个 用 户 保留 一 条 记录 。 

IEnumerable«string» whoLoggedIn = 

dailySecurityLog.Where( 
logEntry -» logEntry.Contains("logged in")).Distinct(); 
Console.WriteLine("Everyone who logged in today:"); 


foreach (string who in whoLoggedIn) 
Console.WriteLine(who) ; 


为 了 使 事情 更 有 趣 一 些 ， 对 于 余下 的 运算 符 ， 我 们 将 处 理 一 家 公司 内 不 同 项 目 上 的 雇员 集 
f, Employee 是 一 个 十 分 简单 的 类 ， 它 包含 一 个 Name 属性 ， 并 且 重 写 了 ToString, Equals 
和 GetHashCode， 如 下 所 示 。 


public class Employee 

































































{ 
public string Name { get; set; } 
public override string ToString() => this.Name; 
public override bool Equals(object obj) => 
this .GetHashCode() .Equals(obj.GetHashCode()); 
public override int GetHashCode() => this.Name.GetHashCode(); 
} 


你 可 能 想 知道 为 什么 要 为 这 样 一 个 简单 的 类 重 载 Equals 和 GetHashCode。 原 因 是 ， 当 
LINQ 对 集合 中 的 元 素 执 行 比较 时 ， 它 会 使 用 默认 的 比较 规则 ， 这 反 过 来 又 会 使 用 Equals 
和 GetHashCode 来 确定 引用 类 型 的 一 个 实例 是 否 与 另 一 个 实例 相同 。 如 果 你 没有 在 引用 类 
型 的 类 中 提供 语义 ， 用 以 确定 对 象 的 两 个 实例 的 数据 相同 时 它们 将 具有 相同 的 散 列 代码 或 
相等 值 ， 那 么 默认 情况 下 这 两 个 实例 将 是 不 同 的 ， 因 为 两 个 引用 类 型 默认 情况 下 具有 不 同 
的 散 列 代码 。 我 们 重 写 了 该 方法 ， 使 得 如 果 每 个 Employee 的 Name 相同 ， 散 列 代 码 和 相等 
值 都 将 正确 地 把 实例 标识 为 相同 的 。 集 合 运 算 符 的 重 载 方法 也 接受 自 定 义 的 比较 器 ， 因 此 
也 可 以 使 你 甚至 能 够 为 无 法 修改 Equals 和 GetHashCode 方法 的 类 提供 比较 语义 。 


在 完成 这 项 任务 后 ， 现 在 就 可 以 把 Employee 指派 给 各 个 项 目 。 


Employee[] project1 = { 

















new Employee(){ Name = "Rakshit" }, 
new Employee(){ Name = "Jason" }, 
new Employee(){ Name = "Josh" }, 





new Employee(){ Name = "Melissa" }, 

new Employee(){ Name = "Aaron" }, 

new Employee() { Name = "Dave" }, 

new Employee() {Name = "Alex" } }; 
Employee[] project2 = { 

new Employee(){ Name = "Mahesh" }, 

new Employee() {Name = "Ken" }, 


new Employee() {Name = "Jesse" }, 
new Employee(){ Name = "Melissa" }, 
new Employee(){ Name = "Aaron" }, 


new Employee(){ Name = "Alex" }, 
new Employee(){ Name = "Mary-Ellen" } }; 
Employee[] project3 = { 

new Employee(){ Name = "Mike" }, 

new Employee(){ Name = "Scott" }, 

new Employee(){ Name = "Melissa" }, 

new Employee(){ Name = "Aaron" }, 

new Employee(){ Name = "Alex" }, 

new Employee(){ Name = "Jon" } }; 


为 了 查找 所 有 项 目 上 的 所 有 Employee， 可 使 用 Union 获取 全 部 三 个 项 目 中 的 所 有 非 重复 的 








Employee 并 输出 它们 ， 因 为 Union 返回 全 部 三 个 项 目 中 的 所 有 非 重复 的 Employee, 
// 并 集 


Console.WriteLine("Employees for all projects"); 

var allProjectEmployees = projecti.Union(project2.Union(project3)); 

foreach (Employee employee in allProjectEmployees) 
Console.WriteLine(employee); 





然后 ， 我 们 可 以 使 用 Intersect 来 获得 参与 了 每 个 项 目的 雇员 ， 因 为 Intersect 将 确定 每 


个 项 目 中 的 公共 Employee 并 返回 它们 。 
// 交集 


Console.WriteLine("Employees on every project"); 

var everyProjectEmployees - projecti.Intersect(project2.Intersect(project3)); 

foreach (Employee employee in everyProjectEmployees) 
Console.WriteLine(employee); 











最 后 ， 我 们 可 以 结合 使 用 Union 和 Except， 找 出 只 在 一 个 项 目 中 的 Employee, [573 Except 


筛选 了 参与 不 止 一 个 项 目的 Employee, 
// 排除 


var intersect1 3 = projecti.Intersect(project3); 
var intersect1 2 = projecti.Intersect(project2); 
var intersect2_3 = project2.Intersect(project3); 
var unionIntersect = intersecti 2.Union(intersecti 3).Union(intersect2 3); 


Console.WriteLine("Employees on only one project"); 

var onlyProjectEmployees - allProjectEmployees.Except(unionIntersect); 

foreach (Employee employee in onlyProjectEmployees) 
Console.WriteLine(employee); 


代码 的 输出 如 下 所 示 。 


Everyone who logged in today: 
Rakshit logged in 
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Aaron logged in 
Ken logged in 
Mahesh logged in 
Jesse logged in 
Jason logged in 
Josh logged in 
Melissa logged in 
Alex logged in 
Scott logged in 
Dave logged in 
Employees for all projects 
Rakshit 

Jason 

Josh 

Melissa 

Aaron 

Dave 

Alex 

Mahesh 

Ken 

Jesse 

Mary-Ellen 

Mike 

Scott 

Jon 

Employees on every project 
Melissa 

Aaron 

Alex 

Employees on only one project 
Rakshit 

Jason 

Josh 

Dave 

Mahesh 

Ken 

Jesse 

Mary-Ellen 

Mike 

Scott 

Jon 


4.2.4 ”参考 


MSDN 文档 中 的 “标准 查询 运算 符 ”“Distinct 方法 ”“Union WYK” “Intersect 方法 ”和 
“Except 方法 ”主题 。 


4.3 利用 LINQ to SQL 重用 参数 化 查询 


4.3.1 问题 
你 需要 利用 不 同 的 参数 值 多 次 执行 相同 的 参数 化 查询 ， 但 是 你 想 避 免 每 次 执行 查询 时 解析 
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查询 表达 式 树 构建 参数 化 SQL 的 开销 。 


4.3.2 ”解决 方案 


使 用 CompiledQuery.Compile 方法 构建 一 个 表达 式 树 ， 每 次 利用 新 参数 执行 查询 时 将 不 必 
解析 它 。 
var GetEmployees = 
CompiledQuery.Compile((NorthwindLinq2Sql.NorthwindLing2SqlDataContext nwdc, 
string ac, string ttl) => 
from employee in nwdc.Employees 
where employee.HomePhone.Contains(ac) && 
employee.Title -- ttl 
select employee); 


var northwindDataContext = new NorthwindLinq2Sql.NorthwindLinq2SqlDataContext(); 


查询 第 一 次 执行 发 生 在 实际 编译 它 时 (在 foreach 循环 中 第 一 次 调用 GetEnployees 
时 )。 本 次 循环 中 所 有 其 他 友 代 及 下 一 次 循环 中 都 将 使 用 编译 过 的 版 本 ， 从 而 避免 解析 
表达 式 树 。 

foreach (var employee in GetEmployees(northwindDataContext, "(206)", 


"Sales Representative") ) 
Console.WriteLine($"{employee.FirstName} {employee.LastName}") ; 





foreach (var employee in GetEmployees(northwindDataContext, "(71)", 
"Sales Manager")) 
Console.WriteLine($"{employee.FirstName} {employee.LastName}") ; 


4.3.3 ”讨论 
我 们 把 var 用 于 查询 声明 ， 因 为 它 更 清晰 ， 但 是 在 这 种 情况 下 var 实际 上 是 : 


System. Func<NorthwindLing2Sql.NorthwindLing2SqlDataContext, string, string, 
System.Ling. IQueryable<NorthwindLinqg2Sql.Employee>> 


它 是 我 们 所 创建 包含 查询 的 lambda 表达 式 的 委托 签名 。 是 的 ， 所 有 这 些 疯 狂 的 查询 ， 我 
们 只 不 过 实例 化 了 一 个 委托 。 公 平地 说 ，Func 委托 是 作为 LINQ 的 一 部 分 添加 到 System 命 
名 空间 中 。 因 此 ， 不 要 诅 来 ， 我 们 仍 将 做 一 些 很 酷 的 新 事情 ! 


这 说 明 我 们 将 不 会 基于 Compile 中 的 结果 集 返 回 一 个 IEnumerable 或 IQueryable， 而 是 
返回 一 个 表达 式 树 ， 它 代表 了 查询 的 潜力 ， 而 不 是 查询 本 身 。 一 旦 有 了 这 个 树 ，LINQ 
to SQL 就 必须 把 它 转换 成 可 用 于 操纵 数据 库 的 实际 SQL 语句 。 十 分 有 趣 的 是 ， 如 果 置 
入 一 个 string.Format 的 调用 作为 检测 家 庭 电话 号 码 中 区 号 的 部 分 ， 我 们 将 会 得 到 一 个 
NotSupportedException， 它 告知 我 们 不 能 把 string.Format 转换 成 SOL, 


where employee.HomePhone.Contains(string.Format($"({ac})")) && 





















































System.NotSupportedException: 
Method ‘System.String Format(System.String,System.Object)' 
has no supported translation to SQL. 
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这 是 可 以 理解 的 ， 因 为 SQL 没有 .NET Framework 方法 用 于 执行 操作 的 概念 ， 但 是 在 设计 
查询 时 要 记 住 这 是 使 用 LINQ to SQL 的 限制 。 

在 第 一 次 执行 之 后 就 编译 了 查询 ， 从 此 之 后 在 每 次 迭代 中 都 无 需 付出 表达 式 树 转换 成 参数 
化 SQL 的 转换 成 本 。 

建议 为 大 量 使 用 的 参数 化 查询 编译 查询 ， 但 是 如 果 查 询 很 少 使 用 ， 可 能 不 值得 这 样 做 。 通 
常 的 做 法 是 ， 训 析 代 码 找 出 这 样 做 有 益 的 领域 。 

请 注意 ， 在 Entity Framework 5 及 以 上 的 模板 里 ， 不 能 在 生成 的 上 文中 使 用 CompiledQuery, 
因为 这 些 模板 重 写 以 用 于 DbContext， 而 不 是 ObjectContext; 而 CompiledQuery.Compile 需 
要 0bjectContext。 好 消息 是 ， 如 果 你 正在 使 用 Entity Framework 5 及 更 高 版 本 ，DbContext 
已 经 为 你 预 编译 了 查询 。 你 仍然 可 以 在 LINQ to SQL 数据 上 下 文中 使 用 Compiledquery, 


Microsoft 建议 在 新 的 开发 项 目 中 使 用 DbCcontext， 但 是 如 果 你 有 使 用 之 前 的 数据 访问 机 制 
的 代码 ，CompiledQuery 仍然 可 以 帮助 你 。 

































































43.4 参考 
MSDN 文档 中 的 “CompiledQuery.Conpile 方法 ”和 “表达 式 树 ” 主 题 。 


4.4 以 文化 敏感 的 方式 对 结果 排序 


4.4.1 问题 


你 想 确保 在 查询 中 排序 时 针对 的 是 应 用 程序 特定 的 文化 ， 而 它 可 能 与 该 线程 的 当前 文化 
不 同 。 


4.4.2 解决 方案 


使 用 orderBy 查询 运算 符 的 重 载 版 本 ， 它 接受 一 个 自 定 义 的 比较 器 ， 用 以 指定 要 执行 比较 
的 文化 。 

// 在 丹麦 创建 一 个 丹麦 语 的 CuLtureInfo 

CultureInfo danish = new CultureInfo("da-DK"); 


// 在 美国 创建 一 个 英语 的 CuLtureInfo 
CultureInfo american = new CultureInfo("en-US"); 

















CultureStringComparer comparer = 
new CultureStringComparer (danish, CompareOptions.None) ; 
var query = names.OrderBy(n => n, comparer); 


44.3 讨论 

如 果 线 程 的 当前 文化 是 你 想 使 用 的 文化 ， 那 么 在 NET 中 处 理 像 对 特定 文化 进行 排序 这 样 
的 本 地 化 问题 就 是 一 种 相对 简单 的 任务 。 在 C# 中 ， 通 过 包括 System.Globalization 命名 
空间 来 访问 那些 帮助 处 理 文化 问题 的 Framework 类 。 为 了 使 解决 方案 中 的 代码 运行 ， 就 要 
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包括 这 个 命名 空间 。 一 个 不 使 用 线程 当前 文化 的 示例 是 ， 在 设置 为 美式 英语 的 Windows 版 
本 上 运行 的 应 用 程序 需要 显示 丹麦 语 中 单词 的 有 序列 表 。 这 一 功能 在 使 用 一 个 多 租户 Web 
服务 或 一 个 有 着 全 球 客户 的 网 站 时 也 很 有 用 。 
应 用 程序 中 的 当前 线程 可 能 有 用 于 美式 英语 (en-US) 的 CultureInfo, RUIE ULT, 
orderBy 的 排序 顺序 将 使 用 当前 文化 的 排序 设置 。 为 了 指定 这 个 列表 应 该 根据 丹麦 语 规则 
进行 排序 ， 需 要 一 小 点 工作 来 自 定义 比较 器 。 


CultureStringComparer comparer = 
new CultureStringComparer (danish, CompareOptions.None) ; 




















comparer 变量 是 自 定义 比较 器 类 CultureStringComparer 的 一 个 实例 ， 这 个 类 被 定义 为 实 
现 专用 于 字符 串 的 IComparer<T> 接口 。 该 类 用 于 为 排序 顺序 提供 文化 设置 。 


public class CultureStringComparer : IComparer<string> 


( 

















private CultureStringComparer() 
{ 
} 


public CultureStringComparer(CultureInfo cultureInfo, CompareOptions options) 


{ 
if (cultureInfo == null) 
throw new ArgumentNullException(nameof(cultureInfo)); 


CurrentCultureInfo - cultureInfo; 
Options = options; 


} 


public int Compare(string x, string y) => 
CurrentCultureInfo.CompareInfo.Compare(x, y, Options); 


public CultureInfo CurrentCultureInfo { get; set; } 


public CompareOptions Options { get; set; } 


} 


为 了 演示 如 何 使 用 它 ， 首 先 编译 一 份 要 排序 的 单词 列表 。 由 于 丹麦 语 把 字符 和 视 为 一 个 单 
独 的 字母 ， 在 字母 表 中 将 其 排 在 z 后面， 而 英语 则 把 字符 E 视 为 一 个 特殊 符号 ， 在 字母 表 
中 将 其 排 在 A 之 前 ， 这 个 例子 将 演示 排序 的 差别 。 


string[] names = { "Jello", "Apple", "Bar", "Able", 
"Forsooth", "Orange", "Zanzibar" }; 


现在 ， 我 们 可 以 为 丹麦 语 和 美式 英语 设置 CuLtureInfo， 并 利用 每 种 文化 特有 的 比较 规 
则 调用 orderBy。 这 个 查询 将 不 会 使 用 查询 表达 式 语法 ， 而 是 使 用 IEnumerabLe<string>. 
OrderBy() 的 函数 式 风 格 。 


// 在 丹麦 创建 一 个 丹麦 语 的 CuLtureInfo 
CultureInfo danish = new CultureInfo("da-DK"); 















































/] 在 美国 创建 一 个 英语 的 CuLtureInfo 
CultureInfo american = new CultureInfo("en-US"); 
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CultureStringComparer comparer = 
new CultureStringComparer (danish, CompareOptions.None) ; 
var query = names.OrderBy(n => n, comparer); 
Console.WriteLine($"Ordered by specific culture : 
$"(comparer.CurrentCultureInfo.Name]"); 
foreach (string name in query) 
Console.WriteLine(name); 


+ 


comparer.CurrentCultureInfo = american; 

query = names.OrderBy(n => n, comparer); 

Console.WriteLine($"Ordered by specific culture : 
$"(comparer.CurrentCultureInfo.Name]"); 

foreach (string name in query) 
Console.WriteLine(name); 


+ 


query = from n in names 
orderby n 
select n; 
Console.WriteLine("Ordered by Thread.CurrentThread.CurrentCulture : 
$"( Thread.CurrentThread.CurrentCulture.Name}") ; 
foreach (string name in query) 
Console.WriteLine(name) ; 





// 在 丹麦 创建 一 个 丹麦 语 的 CultureInfo 
CultureInfo danish = new CultureInfo("da-DK"); 


// 在 美国 创建 一 个 英语 的 CultureInfo 
CultureInfo american = new CultureInfo("en-US"); 























CultureStringComparer comparer = 
new CultureStringComparer(danish, CompareOptions.None) ; 
var query = names.OrderBy(n => n, comparer); 
Console.WriteLine("Ordered by specific culture : 
comparer.CurrentCultureInfo.Name); 
foreach (string name in query) 


{ 
} 


comparer.CurrentCultureInfo = american; 

query = names.OrderBy(n => n, comparer); 

Console.WriteLine("Ordered by specific culture : 
comparer.CurrentCultureInfo.Name); 

foreach (string name in query) 


( 
} 


下 面 的 输出 结果 显示 单词 Able 在 丹麦 语 列表 中 出 现在 最 后 面 ， 而 在 美式 英语 列表 中 则 出 现 
在 最 前 面 


Ordered by specific culture : da-DK 
Apple 

Bar 

Forsooth 


+ 


Console.WriteLine(name) ; 


+ 


Console.WriteLine(name) ; 





















































o 
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Jello 
Orange 
Zanzibar 
Able 
Ordered by specific culture : en-US 
Able 
Apple 
Bar 
Forsooth 
Jello 
Orange 
Zanzibar 


444 参考 


MSDN 文档 中 的 “orderBy 方法 ”“CuLtureInfo 类 ”和 “IComparer<T> 接口 ”主题 。 








4.5 添加 用 于 LINQ 的 函数 式 扩 展 


4.5.1 问题 


你 将 对 集合 频繁 地 执行 一 些 操作 ， 这 些 操作 目前 位 于 实 月 














加 无 颖 的 方式 对 集合 使 用 这 些 操 作 ， 而 不 必 把 对 集合 的 引用 传递 给 实用 程序 类 。 


45.2 ”解决 方案 





使 月 








程序 类 中 。 你 希望 能 够 以 一 种 更 


扩展 方法 帮助 实现 更 加 偏向 函数 式 编程 风格 的 集合 操作 。 例 如 ， 为 了 向 数字 集合 中 添 


加 一 个 加 权 的 移动 平均 计算 操作 ， 可 以 在 一 个 静态 类 中 实现 一 组 WeightedMovingAverage 
扩展 方法 ， 然 后 将 它们 作为 这 些 集合 的 一 部 分 进行 调用 。 


decimal[] prices = new decimal[10] { 13.5M, 17.8M, 92.3M, 0.1M, 15.7M, 
19.99M, 9.08M, 6.33M, 2.1M, 14.88M }; 
Console.WriteLine(prices.WeightedMovingAverage()); 


double[] dprices = new double[10] { 13.5, 17.8, 92.3, 0.1, 15.7, 
19.99, 9.08, 6.33, 2.1, 14.88 }; 
Console.WriteLine(dprices.WeightedMovingAverage()); 


float[] fprices - new float[10] ( 13.5F, 17.8F, 92.3F, 0.1F, 15.7F, 
19.99F, 9.08F, 6.33F, 2.1F, 14.88F }; 
Console.WriteLine(fprices.WeightedMovingAverage()); 


int[] iprices = new int[10] { 13, 17, 92, 0, 15, 
19, 9, 6, 2, 14 5 
Console.WriteLine(iprices.WeightedMovingAverage()); 


long[] lprices = new long[10] { 13, 17, 92, 0, 15, 
19, 9, 6, 2, 14 }; 
Console.WriteLine(lprices.WeightedMovingAverage()); 
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为 了 给 所 有 数字 类 型 提供 WeightedMovingAverage, JE LingExtensions 类 中 提供 了 用 于 可 空 
数字 类 型 和 非 空 数 字 类 型 的 方法 。 


public static class LinqExtensions 
t 
public static decimal? WeightedMovingAverage( 
this IEnumerable<decimal?> source) 
{ 
if (source == null) 
throw new ArgumentNullException(nameof(source)); 


decimal aggregate - 0.0M; 

decimal weight; 

int item - 1; 

11 对 非 空 的 数据 项 计数 ,将 其 作为 加 权 的 因子 

int count = source.Count(val => val.HasValue); 
foreach (var nullable in source) 








if (nullable.HasValue) 


{ 
weight = item / count; 
aggregate += nullable.GetValueOrDefault() * weight; 
count++3 

} 


if (count > 0) 
return new decimal?(aggregate / count); 
return null; 


} 
// 接 下 来 是 跟 如 上 方法 相同 的 方法 模式 ,用 于 每 个 类 型 和 
// 它 对 应 的 可 空 类 型 (double / double? int / int? 等 ) 


4.5.3 讨论 

扩展 方法 允许 你 创建 看 起 来 属于 集合 一 部 分 的 操作 。 它 们 都 是 静态 方法 ， 可 以 像 实例 方法 
一 样 调用 它们 ， 从 而 允许 你 扩展 现 有 类 型 。 必 须 在 未 骨 套 的 静态 类 中 声明 扩展 方法 。 一 旦 
定义 了 带 有 扩展 方法 的 静态 类 ， 用 于 类 的 命名 空间 的 using 指令 就 可 以 在 源 文 件 中 使 用 这 
些 扩 展 。 





如 果 某 个 实例 方法 具有 与 扩展 方法 相同 的 签名 ， 将 永远 不 会 调用 扩展 方法 。 
有 冲突 的 扩展 方法 声明 将 解析 成 最 近 的 封闭 命名 空间 中 的 方法 。 








你 不 能 使 用 扩展 方法 创建 以 下 各 项 。 
。 属性 (get 和 set 方法 ) 

。 运算 符 (+、- 和 = 等 ) 

。 事件 














要 声明 一 个 扩展 方法 ， 在 方法 声明 的 第 一 个 参数 前 面 指定 this 关键 字 ， 并 且 使 该 参数 的 类 
型 是 要 扩展 的 类 型 。 例 如 ， 在 WeightedMovingAverage 方法 的 Nullable<decimal> 版 本 中 ， 
将 支持 那些 支持 IEnumerable«decimal?» (或 IEnumerable<Nullable<decimal>>) 的 集合 。 











public static decimal? WeightedMovingAverage(this IEnumerable<decimal?> source) 
{ 
if (source == null) 
throw new ArgumentNullException(nameof(source)); 


decimal aggregate - 0.0M; 

decimal weight; 

int item - 1; 

// 对 非 空 的 数据 项 计数 ,将 其 作为 加 权 的 因子 

int count = source.Count(val => val.HasValue); 
foreach (var nullable in source) 

















if (nullable.HasValue) 
{ 


weight = item / count; 
aggregate += nullable.GetValueOrDefault() * weight; 
count++ 3 


} 
} 
if (count > 0) 

return new decimal?(aggregate / count); 
return null; 


} 
Systen.Linq.Extensions 类 中 的 扩展 方法 支持 大 量 的 LINQ 功能 ， 包 括 Average 方法 。 
Average 方法 具有 大 多 数 数字 类 型 ， 但 是 没有 提供 short (Int16) 的 重 载 。 我 们 自己 可 以 
轻松 地 为 short 和 Nullable<short> 添加 重 载 来 改正 这 一 点 。 


public static double? Average(this IEnumerable<short?> source) 


( 














if (source -- null) 
throw new ArgumentNullException(nameof(source)); 


double aggregate - 0.0; 
int count - 0; 
foreach (var nullable in source) 
{ 
if (nullable.HasValue) 
t 
aggregate += nullable.GetValueOrDefault(); 
count++ 3; 
} 
} 
if (count > 0) 
return new double?(aggregate / count); 
return null; 


} 


public static double Average(this IEnumerable<short> source) 


( 
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if (source == null) 
throw new ArgumentNullException(nameof(source)); 


double aggregate - 0.0; 

// 使 用 数据 源 中 的 数据 项 计数 
int count = source.Count(); 
foreach (var value in source) 


{ 





aggregate += value; 
if (count > 0) 

return aggregate / count; 
else 

return 0.0; 


} 
public static double? Average<TSource>(this IEnumerable<TSource> source, 
Func<TSource, short?> selector) => 
source.Select<TSource, short?»(selector).Average(); 
public static double Average<TSource>(this IEnumerable<TSource> source, 
Func<TSource, short> selector) => 
source.Select«TSource, short>(selector).Average(); 
#endregion // 扩展 Average 
然后 ， 我 们 可 以 在 基于 short 的 集合 上 调用 Average 方法 ， 就 像 WeightedMovingAverage 
一 样 。 
short[] sprices = new short[10] { 13, 17, 92, 0, 15, 19, 9, 6, 2, 14 }; 


Console.WriteLine(sprices.WeightedMovingAverage()); 


// System.Linq.Extensions 没 有 为 short 实 现 Average, 但 我 们 添加 了 支持 
Console.WriteLine(sprices.Average()); 


454 ”参考 
MSDN 文档 中 的 “扩展 方法 ”主题 。 


46 ” 跨 数 据 库 执行 查询 和 联接 


4.6.1 问题 
你 有 来 自 不 同 数据 区 域 的 两 个 数据 集 ， 和 希望 能 够 组 合 这 些 数 据 并 处 理 它们 。 


4.6.2 ”解决 方案 


使 用 LINQ 桥接 异种 数据 域 。LINQ 被 设计 成 以 相同 的 使 用 方式 跨 不 同 数据 域 ， 并 且 支 持 
使 用 联接 语法 组 合 这 些 数据 集 。 


为 了 演示 这 一 点 ， 我 们 将 把 一 个 全 部 由 类 别 数据 组 成 的 XML 和 来 自 一 个 数据 库 












































(Northwind) 中 的 产品 数据 进行 联接 ， 以 创建 产品 信息 的 一 组 新 数据 ， 其 中 包含 产品 名 称 、 
类 别 描述 和 类 别名 称 。 


Northwind dataContext = 

new Northwind(Settings.Default.NorthwindConnectionString); 
ProductsTableAdapter adapter = new ProductsTableAdapter(); 
Products products = new Products(); 
adapter .Fill(products. Products); 


XElement xmlCategories = XElement.Load("Categories.xml"); 


var expr = from product in products. Products 

where product.Units_In_Stock > 100 

join xc in xmlCategories.Elements("Category") 

on product.Category ID equals int.Parse( 
xc.Attribute("CategoryID").Value) 

select new 

{ 
ProductName = product.Product_Name, 
Category = xc.Attribute("CategoryName").Value, 
CategoryDescription = xc.Attribute("Description").Value 


E 
foreach (var productInfo in expr) 
{ 
Console.WriteLine("ProductName: " + productInfo.ProductName + 
" Category: " + productInfo.Category + 
" Category Description: " + productInfo.CategoryDescription) ; 
} 











新 的 数据 集 将 输出 到 控制 台 ， 但 也 可 以 轻松 地 把 它 重 传 给 另 一 个 方法 ， 在 另 一 个 查询 中 转 
换 它 ， 或 者 把 它 写成 第 三 种 数据 格式 。 


ProductName: Grandma's Boysenberry Spread Category: Condiments Category 
Description: Sweet and savory sauces, relishes, spreads, and seasonings 
ProductName: Gustaf's Knäckebröd Category: Grains/Cereals Category Description: 
Breads, crackers, pasta, and cereal 

ProductName: Geitost Category: Dairy Products Category Description: 

Cheeses 

ProductName: Sasquatch Ale Category: Beverages Category Description: Soft drinks, 
coffees, teas, beer, and ale 

ProductName: Inlagd Sill Category: Seafood Category Description: 

Seaweed and fish 

ProductName: Boston Crab Meat Category: Seafood Category Description: 

Seaweed and fish 

ProductName: Páté chinois Category: Meat/Poultry Category Description: 

Prepared meats 

ProductName: Sirop d'érable Category: Condiments Category Description: 

Sweet and savory sauces, relishes, spreads, and seasonings 

ProductName: Ród Kaviar Category: Seafood Category Description: 

Seaweed and fish 

ProductName: Rhónbráu Klosterbier Category: Beverages Category Description: 
Soft drinks, coffees, teas, beer, and ale 
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46.3 iit 

这 个 解决 方案 组 合 了 来 自 两 个 不 同 数据 域 的 数据 : XML 和 SQL 数据 库 。 在 LINQ HAZ 
前 ， 为 了 执行 该 任务 ， 不 仅 需要 手动 创建 第 三 个 数据 库 用 于 保存 结果 ， 而 且 需 要 为 每 个 数 
据 域 编写 特定 的 代码 以 查询 该 数据 域 ， 从 而 获取 其 中 的 数据 (XPath 用 于 XML; SQL 用 于 
数据 库 ) ， 然 后 手动 把 每 个 数据 域 中 的 结果 集 转移 到 新 的 数据 库 中 。LINQ 允许 编写 查询 来 
组 合 两 个 数据 集 ， 通 过 投影 一 种 新 的 匿名 类 型 自动 构造 一 种 类 型 ， 并 把 相关 的 数据 置 于 新 
构建 的 类 型 中 ， 所 有 这 些 操作 都 采用 相同 的 语法 。 这 不 仅 可 以 简化 代码 ， 而 且 允 许 你 把 注 
意 力 更 多 地 集中 于 获取 你 想 要 的 数据 ， 而 较 少 关注 如 何 准确 地 读 取 两 个 数据 域 。 


这 个 示例 使 用 LINQ to DataSet 和 LINQ to XML 访问 多 个 数据 域 。 









































var dataContext = new NorthwindLinq2Sql.NorthwindLinq2SqlDataContext(); 


ProductsTableAdapter adapter = new ProductsTableAdapter(); 
Products products = new Products(); 
adapter. Fill(products. Products); 


XElement xmlCategories = XElement.Load("Categories.xml"); 


NorthwindLing2SqlDataContext 是 一 个 DataContext 4E, DataContext 类 似 于 一 个 融 为 一 体 
的 ADO.NET Connection 和 Command 对 象 。 你 使 用 它 来 建立 连接 、 执 行 查询 或 者 通过 实体 
类 直接 访问 表 。 可 以 通过 在 Visual Studio 中 添加 一 个 新 的 “LINQ to SQL 类 ”项 直接 从 数 
据 库 生成 DataContext。 这 人 允许 查询 访问 本 地 Northwind.mdf 数据 库 。 从 Northwind.mdf 数 
据 库 中 的 Products 表 加 载 Products Dataset， 以 便 在 查询 中 使 用 它 。 


XElement 是 LINQ to XML 中 的 主要 类 之 一 。 它 允许 加 载 现 有 的 XML、 创 建新 的 XML， 或 


者 通过 ToString 检索 元 素 的 XML 文本 。 例 4-1 显示 了 将 要 加 载 的 Categories.xml X H 
HÆ XElenent fll LINQ to XML 的 更 多 信息 ， 参 见 第 10 章 。 


Nd 


tr 





o 


例 4-1: Categories.xml 
<?xml version="1.0" encoding="utf-8"?> 
<Categories> 
<Category Id="1" Name="Beverages" 
Description="Soft drinks, coffees, teas, beers, and ales" /> 
<Category Id="2" Name="Condiments" 
Description="Sweet and savory sauces, relishes, spreads, and seasonings" /> 
<Category Id="3" Name="Confections" 
Description="Desserts, candies, and sweet breads" /> 
<Category Id="4" Name="Dairy Products" Description="Cheeses" /> 
<Category Id="5" Name="Grains/Cereals" 
Description="Breads, crackers, pasta, and cereal" /> 
<Category Id="6" Name="Meat/Poultry" Description="Prepared meats" /> 
<Category Id="7" Name="Produce" Description="Dried fruit and bean curd" /> 
<Category Id="8" Name="Seafood" Description="Seaweed and fish" /> 
</Categories> 


使 用 LINQ (确切 地 讲 ， 是 使 用 join 关键 字 ) 联接 两 个 数据 集 。 通 过 匹配 产品 表 中 的 类 别 
ID 与 XML 文件 中 的 类 别 ID 来 联接 数据 ， 从 而 组 合 数据 。 在 SQL 术语 中 ，join 关键 字 表 
示 一 个 内 联接 。 








var expr = from product in products. Products 
where product.UnitsInStock > 100 
join xc in xmlCategories.Elements("Category") 


on product.CategoryID equals int.Parse(xc.Attribute("Id").Value) 








一 旦 联接 结果 完成 ， 使 用 select 关键 字 投 影 一 个 新 类 型 。 


select new 

{ 
ProductName = product.ProductName, 
Category = xc.Attribute("Name").Value, 
CategoryDescription = xc.Attribute("Description").Value 





3 
这 允许 我 们 组 合 两 个 数据 集中 的 不 同 数据 元 素 产 生 第 三 个 数据 集 ， 它 看 起 来 可 能 与 原来 的 
两 个 数据 集 完全 不 同 。 
对 数据 库 的 两 个 数据 集 执行 联接 是 一 个 精 糕 的 主意 ， 因 为 数据 库 可 以 为 这 些 数据 集 更 快 地 











执行 这 种 操作 ， 但 是 当 你 需要 联接 异种 数据 集 时 ，LINQ 可 以 提供 帮助 。 


4.6.4 ”参考 

MSDN 文档 中 的 “join 关键 字 ”“System.Data.Linq.DataContext 类 ”和 “XELement 类 ” 
主题 。 

4.7 利用 LINQ 查 询 配置 文件 

4.7.1 问题 





数据 集 可 以 存储 在 许多 不 同 的 位 置 ， 比 如 配置 文件 。 你 希望 能 够 查询 配置 文件 以 获取 信息 


集合 





° 


4.7.2 解决 方案 


使 用 LINQ 来 查询 配置 节 (configuration section)。 在 下 面 的 示例 中 ， 我 们 从 包含 章节 信息 


的 自 





定义 配置 市 中 检索 所 有 包含 and 的 偶数 章 标 题 。 


CSharpRecipesConfigurationSection recipeConfig = 
ConfigurationManager.GetSection("CSharpRecipesConfiguration") as 
CSharpRecipesConfigurationSection; 


var expr = from ChapterConfigurationElement chapter in 
recipeConfig.Chapters.OfType«ChapterConfigurationElement»() 
where (chapter.Title.Contains("and")) && 
((int.Parse(chapter.Number) % 2) == 0) 

select new 

{ 
ChapterNumber = $"Chapter {chapter.Number}", 
chapter.Title 

5 
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foreach (var chapterInfo in expr) 
Console.WriteLine($"{chapterInfo.ChapterNumber} : {chapterInfo.Title}"); 


要 查询 的 配置 节 如 下 所 示 。 


<CSharpRecipesConfiguration CurrentEdition="4"> 

<Chapters> 
<add Number="1" Title="Classes and Generics" /> 
«add Number="2" Title-"Collections, Enumerators, and Iterators" /> 
«add Number="3" Title-"Data Types" /> 
«add Number="4" Title-"LINQ &amp; Lambda Expressions" /» 
«add Number="5" Title-"Debugging and Exception Handling" /> 
«add Number="6" Title="Reflection and Dynamic Programming" /> 
«add Number="7" Title="Regular Expressions" /> 
«add Number="8" Title="Filesystem I/O" /> 
«add Number="9" Title-"Networking and Web" /> 
«add Number="10" Title="XML" /> 
«add Number="11" Title-"Security" /> 
<add Number="12" Title="Threading, Synchronization, and Concurrency" /> 
<add Number="13" Title="Toolbox" /> 

</Chapters> 

<Editions> 
<add Number="1" PublicationYear="2004" /> 
<add Number="2" PublicationYear="2006" /> 
<add Number="3" PublicationYear="2007" /> 
<add Number="4" PublicationYear="2015" /> 

</Editions> 

</CSharpRecipesConfiguration> 


查询 的 输出 如 下 所 示 。 


Chapter 2 : Collections, Enumerators, and Iterators 
Chapter 6 : Reflection and Dynamic Programming 
Chapter 12 : Threading, Synchronization, and Concurrency 





4.7.3 讨论 

NET 中 的 配置 文件 在 实现 基于 NET 的 应 用 程序 的 可 管理 性 和 易于 部 署 方面 起 着 重要 的 作 
用 。 在 配置 文件 的 层次 结构 中 获取 可 能 影响 应 用 程序 的 各 种 设置 可 能 是 一 项 具有 挑战 性 的 
任务 ， 因 此 在 开发 、 测 试 、 部 署 和 管理 应 用 程序 期 间 ， 理 解 如 何 编写 工具 程序 从 而 以 编程 
方式 检查 配置 文件 设置 就 是 一 项 非常 有 意义 的 工作 。 






































为 了 访问 配置 类 型 ， 需 要 引用 System.Configuration 程序 集 。 





即使 ConfigurationElementCollection 类 (配置 文件 中 数据 集 的 基 类 ) 只 支持 IEnumerable 
而 不 支持 IEnumerable<T>， 我 们 仍然 可 以 利用 它 通过 在 集合 上 使 用 OF Type<ChapterConfigu- 
rationElement> 方法 来 获取 所 需 的 元 素 ， 这 将 从 集合 中 选择 此 类 型 的 元 素 。 








var expr = from ChapterConfigurationElement chapter in 


recipeConfig.Chapters.OfType«ChapterConfigurationElement»() 


ChapterConfigurationElement 是 自 定 义 的 配置 节 类 ， 它 保存 有 章 号 和 标题 。 





/// <summary> 
/// 保存 了 配置 文件 中 的 章节 信息 
/// </summary> 





public class ChapterConfigurationElement : ConfigurationElement 


{ 

/// <summary> 

/// 默认 构造 函数 

/// </summary> 

public ChapterConfigurationElement() 

{ 

} 

/// <summary> 

/// 章节 的 编号 

/// </summary> 

[ConfigurationProperty("Number", IsRequired=true) ] 

public string Number 

{ 
get { return (string)this["Number"]; } 
set { this["Number"] = value; } 

} 

/// <summary> 

/// 章节 的 标题 

/// </summary> 

[ConfigurationProperty("Title", IsRequired=true) ] 

public string Title 

{ 
get { return (string)this["Title"]; } 
set { this["Title"] = value; } 

} 

} 


这 一 技术 也 可 以 用 在 像 machine.config 这 样 的 标准 配置 文人 


FF 上。 这 个 示例 确定 machine. 





config 中 的 哪些 区 域 需要 访问 权限 。 对 于 这 个 集合 , 将 使 用 OfType<ConfigurationSection>， 


因为 这 是 一 个 标准 区 域 。 


System.Configuration.Configuration machineConfig = 
ConfigurationManager .OpenMachineConfiguration(); 


var query = from ConfigurationSection section in 

machineConfig. Sections .OfType<ConfigurationSection>() 
where section.SectionInformation.RequirePe 
select section; 


foreach (ConfigurationSection section in query) 
Console.WriteLine(section.SectionInformation.Name) 


检测 到 的 市 看 起 来 如 下 所 示 。 


rmission 


B 
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configProtectedData 
satelliteassemblies 
assemblyBinding 
system.codedom 
system.data.dataset 
system.data.odbc 
system.data 
system.data.oracleclient 
system.data.oledb 

uri 
system.windows.forms 
system.runtime.remoting 
runtime 
system.diagnostics 
windows 

mscorlib 
system.webServer 
system.data.sqlclient 
startup 


474 参考 


MSDN 文档 中 的 “Enumerable.ofType Fy 7” “ConfigurationSectionCollection 类 " 和 
"ConfigurationElementCollection 类 ”主题 。 


4.8 从 数据 库 直 接 创 建 XML 文 件 


4.8.1 问题 
你 希望 能 够 从 数据 库 中 获取 一 个 数据 集 并 将 其 表示 为 XML 文件 。 


4.8.2 解决 方案 


使 用 LINQ to SQL 和 LINQ to XML 在 一 个 查询 中 检索 和 转换 数据 。 在 这 个 示例 中 ， 我 们 
选择 Northwind 数据 库 中 的 前 5 名 客户 ， 他 们 的 联系 方式 是 所 有 者 ， 并 且 这 些 所 有 者 所 下 
订单 的 总 额 都 超过 10 000 美元 ， 然 后 创建 一 个 XML 文件 ， 其 中 包含 公司 名 称 、 联 系 人 姓 
名 、 电 话 号 码 和 订单 总 额 。 最 后 ， 将 结果 写 入 BigSpenders.xml 文件 。 

NorthwindEntities dataContext = new NorthwindEntities(); 


// 将 生成 的 SQL 语句 记录 到 控制 台 


dataContext.Database.Log = Console.WriteLine; 








tr 





























// 选择 前 5 名 客户 ,他 们 的 联系 方式 是 所 有 者 

// 并 且 这 些 所 有 者 所 下 订单 的 总 额 都 超过 16 00058 7c 

var bigSpenders = new XElement("BigSpenders", 
from top5 in 


( 

















(from customer in 


( 


from c in dataContext.Customers 











// 获得 联系 方式 是 所 有 者 
// 并 且 下 过 订单 的 客户 

where c.ContactTitle.Contains("Owner") 

&& c.Orders.Count » 0 

join orderData in 









































( 
from c in dataContext.Customers 
// 获得 联系 方式 是 所 有 者 
// 并 且 下 过 订单 的 客户 
where c.ContactTitle.Contains("Owner") 
&& c.Orders.Count > 0 
from o in c.Orders 
// IRATRA 
join od in dataContext.Order Details 
on o.OrderID equals od.OrderID 
select new 
{ 
c.CompanyName, 
c.CustomerID, 
o.OrderID, 
// 需要 从 订单 明细 中 计算 订单 数值 
//(UnitPrice*Quantity as Total)- 
// (Total*Discount) as NetOrderTotal 
NetOrderTotal = ( 
(((double)od.UnitPrice) * od.Quantity) - 
((((double)od.UnitPrice) * od.Quantity) * 
od.Discount) ) 
} 
) 


on c.CustomerID equals orderData.CustomerID 
into customerOrders 
select new 
t 
c.CompanyName, 
c.ContactName, 
c.Phone, 
// 获得 客户 花费 的 总 额 
TotalSpend = customerOrders.Sum(order => 
order .NetOrderTotal) 


} 


) 

// 只 考虑 花费 大 于 16 6966 的 客户 
where customer.TotalSpend > 10000 
orderby customer.TotalSpend descending 
// 仅 取 花 费 前 5 名 

select new 


( 





CompanyName - customer.CompanyName, 
ContactName - customer.ContactName, 
Phone = customer.Phone, 
TotalSpend = customer.TotalSpend 
}).Take(5) 
).ToList() 
// 将 数据 格式 化 为 XML 


select new XElement("Customer", 
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new XAttribute("companyName", top5.CompanyName), 
new XAttribute("contactName", top5.ContactName), 
new XAttribute("phoneNumber", top5.Phone), 


new XAttribute("amountSpent", 


top5.TotalSpend))); 


using (XmlWriter writer - XmlWriter.Create("BigSpenders.xml")) 


{ 


bigSpenders.WriteTo(writer); 


} 





TJ 











E 查 询 更 容易 一 些 。 


4.8.3 讨论 
LINQ to SQL # LINQ to ADO.NET 的 一 部 分 ， 便 于 快速 进行 数据 库 开 发 。 它 适用 于 几乎 直 


接 对 数据 库 模式 进行 编程 的 情况 ， 在 其 

















在 构建 更 大 的 查询 时 ， 如 果 你 更 擅长 C# 而 不 是 SQL， 那么 可 能 会 发 现 使 用 
国 数 方式 (.Join()) 代替 采用 查询 表达 式 方法 (join x on y equals z) 来 











中 的 大 多 数 情 况 下 ， 强 类 型 化 的 类 与 数据 库 表 之 间 





具有 一 对 一 相关 性 。 如 果 你 处 于 一 om UL, FL ATES FF litle AR 


HEE 经 不 属于 “ 


要 访问 LINQ to SQL 可 视 化 设计 器 ， 可 以 通 
项 或 者 打开 一 个 现 有 的 “LINQ to SQL 类 ”项 











为 数据 库 构建 DataContext 和 实体 类 ， 然 





如 果 你 希望 这 样 做 的 话 )。 


一 个 表 等 于 一 个 实体 的 情况 ”， 
ae 目 中 添加 一 个 新 的 “LINQ to SQL 类 ” 


么 最 好 调查 一 下 LINQ to Entity。 


| (*dbm 文件 ) 打开 此 设计 器 。 这 将 帮助 你 
后 可 以 把 它们 用 于 LINQ (或 者 其 他 的 编程 构造 ， 


DataContext 类 位于 融 为 一 体 的 ADO.NET Connection 和 Command 


对 象 。 你 使 用 它 来 建立 连接 、 执 行 查询 或 者 通过 实体 类 直接 访问 表 。NorthwindLinq2Sqt 数 
据 上 下 文 是 DataContext 的 一 个 强 类 型 化 的 实例 ， 甚 中 部 分 内 容 如 下 所 示 。 


public partial class NorthwindLinq2SqlDataContext : System.Data.Linq.DataContext 


{ 


private static System.Data.Linq.Mapping.MappingSource mappingSource = new 
AttributeMappingSource(); 


#region 
partial 
partial 
partial 
partial 
partial 
partial 
partial 
partial 
partial 
partial 
partial 
partial 
partial 
partial 
partial 
partial 
partial 


Extensibility Method Definitions 


void 
void 
void 
void 
void 
void 
void 
void 
void 
void 
void 
void 
void 
void 


OnCreated(); 

InsertCategory(Category 
UpdateCategory(Category 
DeleteCategory(Category 


instance); 
instance); 
instance); 


InsertTerritory(Territory instance); 
UpdateTerritory(Territory instance); 
DeleteTerritory(Territory instance); 


InsertCustomerCustomerDemo(CustomerCustomerDemo instance); 
UpdateCustomerCustomerDemo(CustomerCustomerDemo instance); 
DeleteCustomerCustomerDemo(CustomerCustomerDemo instance); 
InsertCustomerDemographic(CustomerDemographic instance); 
UpdateCustomerDemographic(CustomerDemographic instance); 
DeleteCustomerDemographic(CustomerDemographic instance); 
InsertCustomer(Customer instance); 

UpdateCustomer(Customer instance); 

DeleteCustomer(Customer instance); 

InsertEmployee(Employee instance); 





partial 
partial 
partial 
partial 
partial 
partial 
partial 
partial 
partial 
partial 
partial 
partial 
partial 
partial 
partial 
partial 
partial 
partial 
partial 
partial 
partial 
partial 
partial 


void 
void 
void 
void 
void 
void 
void 
void 
void 
void 
void 
void 
void 
void 
void 
void 
void 
void 
void 
void 
void 
void 
void 


#endregion 


UpdateEmployee(Employee instance); 
DeleteEmployee(Employee instance); 
InsertEmployeeTerritory(EmployeeTerritory instance); 
UpdateEmployeeTerritory(EmployeeTerritory instance); 
DeleteEmployeeTerritory(EmployeeTerritory instance); 
InsertOrder Detail(Order Detail instance); 
UpdateOrder Detail(Order Detail instance); 
DeleteOrder Detail(Order Detail instance); 


InsertOrder(Order instance); 
UpdateOrder(Order instance); 
DeleteOrder(Order instance); 
InsertProduct(Product instance); 
UpdateProduct(Product instance); 
DeleteProduct(Product instance); 
InsertRegion(Region instance); 
UpdateRegion(Region instance); 
DeleteRegion(Region instance); 
InsertShipper(Shipper instance); 
UpdateShipper(Shipper instance); 
DeleteShipper(Shipper instance); 


InsertSupplier(Supplier instance); 
UpdateSupplier(Supplier instance); 
DeleteSupplier(Supplier instance); 


public NorthwindLing2SqlDataContext() : 


base( 
global::NorthwindLinq2Sql.Properties.Settings. 
mappingSource) { 
OnCreated(); 
} 


public NorthwindLing2SqlDataContext(string 


{ 
} 


public NorthwindLing2SqlDataContext (System. 


{ 
} 


public NorthwindLing2SqlDataContext(string 
System.Data.Linq.Mapping.MappingSource 


( 
} 


OnCr 


OnCr 


OnCr 


base(connection, mappingSource) 


eated(); 


base(connection, mappingSource) 


eated(); 


base(connection, mappingSource) 


eated(); 


connection) : 


connection, 
MappingSource) : 


public NorthwindLing2SqlDataContext(System.Data.IDbConnection connection, 
System.Data.Linq.Mapping.MappingSource mappingSource) : 


{ 


base(connection, mappingSource) 


Data.IDbConnection connection) : 


Default.NorthwindConnectionString, 
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OnCreated(); 


} 
public System.Data.Linq.Table«Category» Categories 
{ 
get 
{ 
return this.GetTable<Category>(); 
} 
} 
public System.Data.Ling.Table<Territory> Territories 
x 
get 
{ 
return this.GetTable<Territory>(); 
} 
} 


public System.Data.Linq.Table«CustomerCustomerDemo» CustomerCustomerDemos 


{ 
get 


{ 
} 


return this.GetTable«CustomerCustomerDemo»(); 


j 


public System.Data.Linq.Table«CustomerDemographic» CustomerDemographics 


{ 


get 
{ 
return this.GetTable<CustomerDemographic>(); 
} 
} 
public System.Data.Linq.Table<Customer> Customers 
{ 
get 
{ 
return this.GetTable<Customer>(); 
} 
} 
public System.Data.Linq.Table<Employee> Employees 
{ 
get 
{ 
return this.GetTable<Employee>(); 
} 
} 


public System.Data.Linq.Table<EmployeeTerritory> EmployeeTerritories 


{ 
get 





return this.GetTable<EmployeeTerritory>(); 


} 
} 
public System.Data.Linq.Table«Order Detail» Order Details 
{ 
get 
{ 
return this.GetTable<Order_Detail>(); 
} 
} 
public System.Data.Linq.Table«Order» Orders 
{ 
get 
{ 
return this.GetTable«Order»(); 
} 
} 
public System.Data.Linq.Table«Product» Products 
{ 
get 
{ 
return this.GetTable<Product>(); 
} 
} 
public System.Data.Linq.Table«Region» Regions 
{ 
get 
{ 
return this.GetTable<Region>(); 
} 
} 
public System.Data.Linq.Table«Shipper» Shippers 
{ 
get 
{ 
return this.GetTable<Shipper>(); 
} 
} 
public System.Data.Linq.Table«Supplier» Suppliers 
{ 
get 
{ 
return this.GetTable<Supplier>(); 
} 
} 


} 


Northwind 数据 库 的 实体 类 也 都 展示 在 生成 的 代码 中 ， 其 中 每 个 表 都 定义 了 一 个 实体 类 。 
实体 类 通过 不 带 参数 的 Table 特性 指示 。 这 意味 着 实体 类 的 名 称 与 表 的 名 称 相 匹 配 。 
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[global: :System.Data.Ling.Mapping. TableAttribute(Name="dbo.Customers") ] 
public partial class Customer : INotifyPropertyChanging, INotifyPropertyChanged 
{ 

private static PropertyChangingEventArgs emptyChangingEventArgs = new 
PropertyChangingEventArgs(String. Empty); 


private string _CustomerID; 
private string _CompanyName; 
private string _ContactName; 
private string _ContactTitle; 
private string _Address; 

private string _City; 

private string _Region; 

private string _PostalCode; 
private string _Country; 

private string _Phone; 

private string _Fax; 

private EntitySet<CustomerCustomerDemo> _CustomerCustomerDemos; 
private EntitySet<Order> _Orders; 


#region Extensibility Method Definitions 

partial void OnLoaded(); 

partial void OnValidate(System.Data.Ling.ChangeAction action); 
partial void OnCreated(); 

partial void OnCustomerIDChanging(string value); 
partial void OnCustomerIDChanged(); 

partial void OnCompanyNameChanging(string value); 
partial void OnCompanyNameChanged(); 

partial void OnContactNameChanging(string value); 
partial void OnContactNameChanged(); 

partial void OnContactTitleChanging(string value); 
partial void OnContactTitleChanged(); 

partial void OnAddressChanging(string value); 
partial void OnAddressChanged(); 

partial void OnCityChanging(string value); 
partial void OnCityChanged(); 

partial void OnRegionChanging(string value); 
partial void OnRegionChanged(); 

partial void OnPostalCodeChanging(string value); 
partial void OnPostalCodeChanged(); 

partial void OnCountryChanging(string value); 
partial void OnCountryChanged(); 

partial void OnPhoneChanging(string value); 
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partial void OnPhoneChanged(); 

partial void OnFaxChanging(string value); 
partial void OnFaxChanged(); 

#endregion 


public Customer() 
{ 
this._CustomerCustomerDemos = new EntitySet<CustomerCustomerDemo>(new 
Action<CustomerCustomerDemo>(this.attach_CustomerCustomerDemos), new 
Action«CustomerCustomerDemo»(this.detach CustomerCustomerDemos)); 
this. Orders = new EntitySet«Order»( 
new Action«Order»(this.attach Orders), new 
Action<Order>(this.detach_Orders)); 
OnCreated(); 
} 


public event PropertyChangingEventHandler PropertyChanging; 
public event PropertyChangedEventHandler PropertyChanged; 


protected virtual void SendPropertyChanging() 


{ 
if ((this.PropertyChanging != null)) 
{ 
this.PropertyChanging(this, emptyChangingEventArgs) ; 
} 
} 
protected virtual void SendPropertyChanged(String propertyName) 
{ 
if ((this.PropertyChanged != null)) 
{ 
this.PropertyChanged(this, 
new PropertyChangedEventArgs(propertyName) ); 
} 
} 


标准 属性 改变 通知 是 通过 INotifyPropertyChanging 和 INotifyPropertyChanged 实现 的 , 


并 


且 包 含 PropertyChanging 和 PropertyChanged 事件 ， 用 于 传达 属性 的 改变 。 还 有 一 组 分 部 
方法 ， 如 果 是 在 实体 类 的 另 一 个 分 部 类 定义 中 实现 了 分 部 方法 ， 那 么 在 这 个 实体 类 上 修改 





属性 时 ， 它 将 会 调用 这 些 方法 。 

很 多 Microsoft .NET 生成 的 类 都 是 作为 分 部 类 生成 的 。 这 样 就 可 以 在 你 自己 
的 分 部 类 中 扩展 它们 ， 并 向 类 添加 方法 和 属性 ， 而 不 会 在 代码 生成 器 下 次 重 
新 生 新 代码 时 产生 混乱 的 代码 。 

在 这 种 情况 下 ， 如 果 没 有 发 现 其 他 的 分 部 类 定义 ， 编 译 器 将 删除 这 些 通 知 。 
分 部 方法 允许 在 分 部 类 声明 的 一 个 文件 中 声明 方法 签名 并且 在 另 一 个 文件 
中 实现 该 方法 。 如 果 编 译 器 找到 了 签名 但 没有 找到 实现 ， 它 就 会 删除 该 签名 。 





pu 



























































实体 类 中 的 属性 通过 Column 特性 与 数据 库 中 的 列 匹配 ， 其 中 Name 值 是 数据 库 列 名 ， 








Storage 值 是 类 数据 的 内 部 存储 。 用 于 改变 属性 的 事件 被 编码 进 属性 的 设置 器 中 。 
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[global::System.Data.Linq.Mapping.ColumnAttribute(Storage-" CompanyName", 
DbType="NVarChar(40) NOT NULL", CanBeNull-false)] 
public string CompanyName 


{ 
get 
{ 
return this._CompanyName; 
} 
set 
if ((this._CompanyName != value)) 
{ 
this .OnCompanyNameChanging(value) ; 
this.SendPropertyChanging(); 
this. CompanyName - value; 
this.SendPropertyChanged("CompanyName"); 
this.OnCompanyNameChanged(); 
} 
} 
} 


对 于 一 对 多 子 关 系 ， 可 以 利用 Association 特性 声明 子 实 体 类 的 EntitySet<T>。 
Association 特性 指定 了 父 实 体 类 与 子 实体 类 之 间 的 关系 信息 ， 如 下 面 用 于 Customer 上 的 
orders 属性 的 代码 所 示 。 
[global::System.Data.Linq.Mapping.AssociationAttribute(Name-"Customer Order", 
Storage-" Orders", ThisKey="CustomerID", OtherKey="CustomerID") ] 
public EntitySet«Order» Orders 


{ 








get 
{ 


return this._Orders; 


this. Orders.Assign(value); 


} 


LINQ to SQL 能 够 做 的 事情 远 不 止 上 面 展 示 的 这 些 ， 我 们 鼓励 你 更 深入 地 调查 它 。 但 是 现 
在 让 我 们 转换 到 将 要 处 理 的 另 一 个 数据 域 : LINQ to XML, 


LINQ to XML 不 仅 涉及 如 何 对 XML 执行 查询 ， 而 且 是 一 种 对 开发 人 员 更 友好 的 XML 处 
理 方式 。LINQ to XML 中 的 主要 类 之 一 是 XElement， 它 允许 你 以 一 种 更 类 似 于 XML 自身 
结构 的 方式 创建 XML。 这 似乎 并 不 是 很 重要 ， 但 是 当 你 可 以 在 代码 中 看 到 XML 的 形态 
时 ， 就 更 容易 知道 你 所 处 的 位 置 。( 曾 经 忘记 过 处 在 哪个 xmLwrtiter.WriteEndELment 上 吗 ? 
我 们 就 有 过 这 种 经 历 ! ) 在 第 10 章 中 可 以 获得 关于 使 用 XElement 的 详细 信息 和 示例 ， 医 
此 我 们 不 会 在 此 处 作 进 一 步 的 介绍 ， 但 是 如 你 所 见 ， 在 查询 中 构建 XML 是 很 容易 的 。 


查询 的 第 一 部 分 涉及 建立 主要 的 XML 元 素 BigSpenders， 以 及 获取 其 联系 方式 是 所 有 者 的 
初始 客户 集合 。 






















































































var bigSpenders = new XElement("BigSpenders", 


from top5 in 
( 
(from customer in 
( 
from c in dataContext.Customers 
// 获取 联系 方式 是 所 有 者 ， 
// 并 且 下 过 订单 的 客户 
where c.ContactTitle.Contains("Owner") 
&& c.Orders.Count > 0 























查询 的 中 间 部 分 涉及 把 订单 和 订单 详细 信息 与 客户 信息 联接 起 来 ， 用 以 获取 订单 各 


5 
NetorderTotaL。 它 还 会 创建 包含 此 值 的 订单 数据 、 客 户 和 订单 ID 以 及 公司 名 称 。 在 查询 














的 最 后 一 部 分 中 需要 NetorderTotal， 冤 请 期 待 ! 


join orderData in 


( 


from c in dataContext.Customers 

// 获得 联系 信息 是 所 有 者 ， 

// 并 且 下 过 订单 的 客户 

where c.ContactTitle.Contains("Owner") 
&& c.Orders.Count > 0 

from o in c.Orders 

// 获得 订单 明细 

join od in dataContext.OrderDetails 
on o.O0rderID equals od.OrderID 

select new 


{ 








c.CompanyName, 

c.CustomerID, 

o.OrderID, 

// 需要 从 订单 明细 中 计算 订单 数值 
//(UnitPrice*Quantity as Total) 
//(Total*Discount) 

// as NetOrderTotal 
NetOrderTotal = ( 








(((double)od.UnitPrice) * od.Quantity) - 
((((double)od.UnitPrice) * od.Quantity) * od.Discount)) 


) 


on c.CustomerID equals orderData.CustomerID 
into customerOrders 


查询 的 最 后 一 部 分 对 生成 的 customerOrders 集合 中 的 NetOrderTotal 应 用 Sum 国 数 ， 跨 
所 有 订单 确定 该 客户 的 Totatspend。 最 后 ， 查 询 使 用 Take 函数 只 选择 其 Totalspend 值 大 
于 10 000 的 前 5 名 客户 。(Take 等 价 于 SQL 中 的 TOP.) 然后 使 用 这 些 记 录 构 造 一 个 内 部 


























Customer 元 素 ， 其 属性 笠 套 开始 于 查询 第 一 部 分 中 的 BigSpenders 根 元 素 内 。 





select new 

{ 
c.CompanyName, 
c.ContactName, 
c.Phone, 
// 获得 客户 花费 的 总 额 
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TotalSpend = customerOrders.Sum(order => order. NetOrderTotal) 


} 
) 
|| 只 考虑 花费 大 于 19 666 的 客户 


where customer.TotalSpend > 10000 
orderby customer.TotalSpend descending 
// 仅 取 花 费 前 5 名 


select customer).Take(5) 


) 

// 将 数据 格式 化 为 XML 

select new XElement("Customer", 
new XAttribute("companyName", top5.CompanyName), 
new XAttribute("contactName", top5.ContactName), 
new XAttribute("phoneNumber", top5.Phone), 
new XAttribute("amountSpent", top5.TotalSpend))); 





PERDITE, EK ANKE WAEA AARAA, — EA 
部 查询 生效 ， 就 把 它们 组 合 在 一 起 。 








此 时 ， 对 于 这 里 的 所 有 代码 ， 还 没有 发 生 任何 事情 。 这 是 对 的 : 在 访问 查询 之 前 ， 因 为 
延迟 执行 而 导致 什么 也 没有 发 生 。LINQ 构造 了 一 个 查询 表达 式 ， 但 是 没有 对 数据 库 做 
什么 事情 ， 内存 中 也 没有 XML。 一 旦 在 bigspenders 查询 表达 式 上 调用 WriteTo 方 法， 
LINQ to SQL 就 会 对 查询 求 值 ， 并 构造 XML。WriteTo 方法 将 把 构造 的 XML 写 入 提供 的 
xmtnriter， 我 们 就 完成 了 整个 操作 。 


using (XmlWriter writer = XmlWriter.Create("BigSpenders.xml")) 


{ 














bigSpenders.WriteTo(writer); 

















如 果 你 对 SQL 代码 感 兴趣 ， 可 以 把 DataContext.Log 属性 连接 到 一 个 Textwriter (例如 控 
制 台 )。 


// 将 生成 的 SQL 语句 记录 到 控制 台 
dataContext.Log = Console.Out; 


这 个 查询 生成 的 SQL 代码 如 下 所 示 。 


Generated SQL for query - output via DataContext.Log 
SELECT [t10].[CompanyName], [t10].[ContactName], [t10].[Phone], 
[t10].[TotalSpend] 
FROM ( 
SELECT TOP (5) [t0].[Company Name] AS [CompanyName], 
[t0].[Contact Name] AS 
[ContactName], [t0].[Phone], [t9].[value] AS [TotalSpend] 
FROM [Customers] AS [t0] 
OUTER APPLY ( 
SELECT COUNT(*) AS [value] 
FROM [Orders] AS [t1] 
WHERE [ti].[Customer ID] = [t0].[Customer ID] 





) AS [t2] 

OUTER APPLY ( 
SELECT SUM([t8].[value]) AS [value] 
FROM ( 

SELECT [t3].[Customer ID], [t6].[Order ID], 
([t7].[Unit Price] * 
(CONVERT(Decimal(29,4),[t7].[Quantity]))) - 

([t7].[Unit Price] * 
(CONVERT(Decimal(29,4),[t7].[Quantity])) * 
(CONVERT(Decimal(29,4),[t7].[Discount]))) AS 
[value], 
[t7].[Order ID] AS [Order ID2], 
[t3].[Contact Title] AS [ContactTitle], 
[t5].[value] AS [value2], 
[t6].[Customer ID] AS [CustomerID] 
FROM [Customers] AS [t3] 
OUTER APPLY ( 

SELECT COUNT(*) AS [value] 

FROM [Orders] AS [t4] 

WHERE [t4].[Customer ID] = [t3].[Customer ID] 

) AS [t5] 

CROSS JOIN [Orders] AS [t6] 
CROSS JOIN [Order Details] AS [t7] 
) AS [t8] 

WHERE ([t0].[Customer ID] = [t8].[Customer ID]) AND ([t8].[Order ID] = [ 
t8].[Order ID2]) AND ([t8].[ContactTitle] LIKE @p0) AND ([t8].[value2] > @p1) AN 
D ([t8].[CustomerID] = [t8].[Customer ID]) 

) AS [t9] 
WHERE ([t9].[value] > @p2) AND ([tO0].[Contact Title] LIKE @p3) AND 
([t2].[va 
lue] » Qp4) 
ORDER BY [t9].[value] DESC 
) AS [t10] 
ORDER BY [t10].[TotalSpend] DESC 
-- @p0: Input String (Size = 0; Prec = 0; Scale = 0) [XOwner*] 
-- @p1: Input Int32 (Size = 0; Prec = 0; Scale = 0) [0] 
-- (p2: Input Decimal (Size = 0; Prec = 29; Scale = 4) [10000] 
-- (p3: Input String (Size = 0; Prec = 0; Scale = 0) [%Owner%] 
-- @p4: Input Int32 (Size = 0; Prec = 0; Scale = 0) [0] 
-- Context: SqlProvider(SqlCE) Model: AttributedMetaModel Build: 3.5.20706.1 


最 终 的 XML 如 下 所 示 。 


<BigSpenders> 
<Customer companyName="Folk och fa HB" contactName="Maria Larsson" 
phoneNumber="0695-34 67 21" amountSpent="39805.162472039461" /> 
<Customer companyName="White Clover Markets" contactName="Karl Jablonski" 
phoneNumber="(206) 555-4112" amountSpent="35957.604972146451" /> 
<Customer companyName="Bon app'" contactName="Laurence Lebihan" 
phoneNumber="91.24.45.40" amountSpent="22311.577472746558" /> 
<Customer companyName="LINO-Delicateses" contactName="Felipe Izquierdo" 
phoneNumber="(8) 34-56-12" amountSpent="20458 .544984650609" /> 
<Customer companyName="Simons bistro" contactName="Jytte Petersen" 
phoneNumber="31 12 34 56" amountSpent="18978. 777493602414" /> 
</BigSpenders> 
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4.84 参考 


MSDN x f P AY "Introduction to LINQ Queries” “DataContext.Log Ja HE” “DataContext 
类 ” “XELement 类 ” 和 “LINQ to SQL” 主题 。 


4.9 有 选择 地 输出 查询 结果 


4.9.1 问题 
你 希望 能 够 获取 查询 结果 的 动态 子 集 


49.2 解决 方案 
使 用 Takewhtte 扩展 方法 获取 与 条 件 匹配 的 所 有 结果 ， 直 到 遇 到 第 一 个 不 满足 条 件 的 记录 。 


NorthwindEntities dataContext = new NorthwindEntities(); 




















// 找到 所 有 供应 商 的 产品 
var query = 
dataContext.Suppliers.GroupJoin(dataContext.Products, 
s => s.SupplierID, p => p.SupplierID, 
(s, products) => new 
{ 
s.CompanyName, 
s.ContactName, 
s.Phone, 
Products = products 
}).OrderByDescending(supplierData => supplierData.Products.Count()); 


var results = 
query.AsEnumerable().TakeWhile(supplierData => 
supplierData.Products.Count() > 3); 
Console.WriteLine($"Suppliers that provide more than three products: 
$"(results.Count())"); 
foreach (var supplierData in results) 


+ 


{ 
Console.WriteLine($" Company Name : {supplierData.CompanyName}") ; 
Console.WriteLine($" Contact Name : {supplierData.ContactName}") ; 
Console.WriteLine($" Contact Phone : {supplierData.Phone}"); 
Console.WriteLine($" Products Supplied : {supplierData.Products.Count()}"); 
foreach (var productData in supplierData.Products) 

Console.WriteLine($" Product: {productData.ProductName}"); 
} 


遇 到 不 满足 条 件 的 记录 ， 你 也 可 以 使 用 Skipwhile 扩展 方法 获取 所 有 结果 。 


NorthwindEntities dataContext = new NorthwindEntities(); 


// 找到 所 有 供应 商 的 产品 
var query = 
dataContext.Suppliers.GroupJoin(dataContext.Products, 








S => s.SupplierID, p => p.SupplierID, 
(s, products) -» new 
{ 

s.CompanyName, 

s.ContactName, 

s.Phone, 

Products = products 


}).OrderByDescending(supplierData => supplierData.Products.Count()); 


var results = 
query.AsEnumerable().SkipWhile(supplierData => 
supplierData.Products.Count() > 3); 


Console.WriteLine($"Suppliers that provide more than three products: " + 
$"{results.Count()}"); 

foreach (var supplierData in results) 

{ 
Console.WriteLine($" Company Name : {supplierData.CompanyName}") ; 
Console.WriteLine($" Contact Name : {supplierData.ContactName}"); 
Console.WriteLine($" Contact Phone : {supplierData.Phone}"); 
Console.WriteLine($" Products Supplied : {supplierData.Products.Count()}"); 
foreach (var productData in supplierData.Products) 

Console.WriteLine($" Product: {productData.ProductName}"); 
} 


49.3 Wit 


















































对 结果 排序 。 


从 该 结果 中 ， 仅 当 供 应 商 提供 了 3 件 以 上 的 产品 时 ， 才 会 把 该 供应 商 数 据 纳 入 最 


中 ， 


var query = 
dataContext.Suppliers.GroupJoin(dataContext.Products, 
S => s.SupplierID, p => p.SupplierID, 
(s, products) -» new 
{ 
s.CompanyName, 
s.ContactName, 
s.Phone, 
Products = products 


}).OrderByDescending(supplierData => supplierData.Products.Count()); 








在 这 个 使 用 LINQ to SQL 的 示例 中 ， 确 定 每 个 供应 商 提 供 的 产品 数量 ， 并 按 产品 数 以 降序 


















































wed 








巴 供 应 商 纳入 结果 集中 。 





如 果 代 之 以 使 用 skipWhile， 则 将 返 





var results = query.AsEnumerable().TakeWhile(supplierData => 
supplierData.Products.Count() > 3); 

















下 所 示 。 


var results = query.AsEnumerable().SkipWhile(supplierData => 
supplierData.Products.Count() > 3); 


终结 


Ya 


采集 


并 显示 结果 。TakeWhile 与 lambda 表达 式 一 起 用 于 确定 产品 数 是 否 大 于 3; 如果 是 ， 


回 提 供 了 3 件 或 3 件 以 下 产品 的 所 有 供应 商 ， 代 码 如 
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能 够 编写 基于 代码 的 条 件 提 供 了 比 常规 的 Take 和 Skip 方法 (它们 基于 绝对 记录 数 ) 更 大 
的 灵活 性 ， 但 要 记 住 ， 一旦 达到 TakeWhile 或 Skiphhile 的 条 件 之 后 ， 你 就 获得 了 所 有 的 








记录 。 因 此 ， 在 使 用 它们 之 前 对 结果 集 进 行 排序 很 重要 。 





查询 还 使 用 了 GroupJoin， 它 类 似 于 SQL 中 的 LEFT OUTER JOIN 或 RIGHT OUTER JOIN， 但 不 
会 平 铺 结果 。GroupJoin 会 产生 层次 式 的 结果 集 ， 而 不 是 表格 式 的 结果 集 。 在 这 个 示例 中 ， 




















它 用 于 获得 供应 商 的 产品 集合 。 


dataContext.Suppliers.GroupJoin(dataContext.Products, 


S => s.SupplierID, p => p.SupplierID, 


以 下 是 TakeWhite Hég H 


Suppliers that provide more than three products: 4 
Company Name : Pavlova, Ltd. 
Contact Name : Ian Devling 
Contact Phone : (03) 444-2343 
Products Supplied : 5 
Product: Pavlova 
Product: Alice Mutton 
Product: Carnarvon Tigers 
Product: Vegie-spread 
Product: Outback Lager 





co 


o 


Company Name : Plutzer Lebensmittelgrokmarkte AG 


Contact Name : Martin Bein 
Contact Phone : (069) 992755 
Products Supplied : 5 
Product: Róssle Sauerkraut 
Product: Thüringer Rostbratwurst 
Product: Wimmers gute Semmelknódel 
Product: Rhónbràu Klosterbier 
Product: Original Frankfurter grüne Soke 
Company Name : New Orleans Cajun Delights 
Contact Name : Shelley Burke 
Contact Phone : (100) 555-4822 
Products Supplied : 4 
Product: Chef Anton's Cajun Seasoning 
Product: Chef Anton's Gumbo Mix 
Product: Louisiana Fiery Hot Pepper Sauce 
Product: Louisiana Hot Spiced Okra 
Company Name : Specialty Biscuits, Ltd. 
Contact Name : Peter Wilson 
Contact Phone : (161) 555-4448 
Products Supplied : 4 
Product: Teatime Chocolate Biscuits 
Product: Sir Rodney's Marmalade 
Product: Sir Rodney's Scones 
Product: Scottish Longbreads 


4.9.4 ”参考 


MSDN x fü 中 AY “Enumerable.TakeWhile Jy iA " “Enumerable.SkipWhile Fy y " 





“Enumerable.GroupJoin 方法 ”主题 。 


和 
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4.10 将 LINQ 用 于 不 支持 IEnumerabLe<T> 的 集合 


4.10.1 问题 


有 一 大 批 集合 不 支持 IEnumerable 或 ICollection 的 泛 型 版 本 ,但 是 却 支持 IEnumerable 或 
ICollection 接口 的 原始 非 泛 型 版 本 ， 你 希望 能 够 使 用 LINQ 查询 这 些 集合 。 


4.10.2 ”解决 方案 


不 能 从 原始 IEnumerable 或 ICollection 接 口 推断 类 型 ， 因 此 必须 使 用 0fType<T> 或 
Cast<T> 扩展 方法 提供 它 ， 或 者 在 from 子 句 中 指定 类 型 ， 它 将 为 你 插入 一 个 Cast<T>。 第 
一 个 示例 使 用 Cast<XmLNode> 让 LINQ 知道 从 XmlDocument. SelectNodes 返回 的 XmlNodeList 
中 的 元 素 是 XnlNode 类 型 。 有 关 如 何 使 用 OF Type<T> 扩展 方法 的 示例 ， 参 见 4.10.3 节 。 


// 创建 一 些 XML 以 在 LINQ 中 使 用 这 些 
// 不 直接 支持 IEnumerabLe<T> 的 类 型 
XElement xmlFragment = new XElement("NonGenericLinqableTypes", 
new XElement("IEnumerable", 
new XElement("System.Collections", 
new XElement("ArrayList"), 
new XElement("BitArray"), 
new XElement("Hashtable"), 
new XElement("Queue"), 
new XElement("SortedList"), 
new XElement("Stack")), 
new XElement("System.Net", 
new XElement("CredentialCache")), 
new XElement("System.Xml", 
new XElement("XmlNodelist")), 
new XElement("System.Xml.XPath", 
new XElement("XPathNodeIterator"))), 
new XElement("ICollection", 
new XElement("System.Diagnostics", 
new XElement("EventLogEntryCollection")), 
new XElement("System.Net", 
new XElement("CookieCollection")), 
new XElement("System.Security.AccessControl", 
new XElement("GenericAcl")), 
new XElement("System.Security", 
new XElement("PermissionSet")))); 





L 





ys 






































XmlDocument doc = new XmlDocument(); 
doc.LoadXml(xmlFragment.ToString()); 


// 选择 位 于 IEnumerable 之 下 包含 子 元 素 , 名 称 为 System.Collections 

// 并 且 名 称 中 包含 大 写字 母 5 的 节点 的 名 称 ， 

// 以 降序 返回 结果 列表 

var query = 

from node in 
doc. SelectNodes("/NonGenericLingableTypes/IEnumerable/*") .Cast<XmlNode>( ) 
where node.HasChildNodes && 
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node.Name == "System.Collections" 
from XmlNode xmLNode in node.ChildNodes 
where xmlNode.Name.Contains('S') 
orderby xmlNode.Name descending 
select xmlNode.Name; 


foreach (string name in query) 
Console.WriteLine(name); 


第 二 个 示例 操作 应 用 程序 事件 日 志 ， 并 检索 在 过 去 6 小 时 内 发 生 的 错误 。 在 from 关键 字 后 
面 提供 了 集合 中 的 元 素 类 型 (EventLogEntry)， 它 允许 LINQ 推断 它 所 需 的 关于 集合 元 素 
类 型 的 其 余 信 息 。 
EventLog log = new EventLog("Application"); 
query = from EventLogEntry entry in log.Entries 
where entry.EntryType == EventLogEntryType.Error && 


entry.TimeGenerated > DateTime.Now.Subtract(new TimeSpan(6, 0, 0)) 
select entry.Message; 


Console.WriteLine($"There were {query.Count<string>()}" + 

" Application Event Log error messages in the last 6 hours!"); 
foreach (string message in query) 

Console.WriteLine(message) ; 


4.10.3 讨论 


Cast<T> 会 将 IEnumerable 转换 成 TEnumerable<T>， 使 得 LINQ 可 以 以 一 种 强 类 型 化 的 方式 
访问 集合 中 的 每 一 项 。 在 使 用 Cast<T> 之 前 ， 有 必要 检查 集合 中 的 所 有 元 素 确 实 都 是 类 型 
T， 否 则 如 果 元 素 的 类 型 不 能 转换 成 指定 的 类 型 T， 会 得 到 一 个 InvalidCastException, [A 
为 将 使 用 类 型 强制 转换 所 有 的 元 素 。 把 元 素 的 类 型 置 于 from 关键 字 后 面 时 ， 其 作用 就 像 


Cast<T> 一 样 























o 


ArrayList stuff - new ArrayList(); 
stuff.Add(DateTime.Now); 
stuff.Add(DateTime.Now); 

stuff .Add(1); 
stuff.Add(DateTime.Now); 


var expr = from item in stuff.Cast<DateTime>() 
select item; 
foreach (DateTime item in expr) 
Console.WriteLine(item); 


AFERRA, LAKRA, A Shh RAK Cast<T> 或 from 的 


E 
FF TE o 








解决 这 个 问题 的 另 一 种 方式 是 使 用 ofType<T>， 因 为 它 只 会 返回 特定 类 型 的 元 素 ， 而 不 会 
尝试 把 元 素 从 一 种 类 型 强制 转换 为 另 一 种 类 型 。 
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var expr = from item in stuff.OfType<DateTime>() 
select item; 
// 仅 有 三 个 都 是 DateTime 的 元 素 返 区 
// 不 会 触发 异常 
foreach (DateTime item in expr) 
Console.WriteLine(item) ; 














410.4 ”参考 


MSDN 文档 中 的 “ofType<TResuLt> 方法 ”和 “Cast<TResult> 方法 ”主题 。 


4.11 执行 高 级 接口 查找 


4.11.1 问题 


你 将 使 用 Type 类 查找 某 个 接口 。 不 过 ，Type 对 象 的 GetInterface 和 GetInterfaces 方法 没 
有 提供 复杂 的 接口 查找 。 


4.11.2 ”解决 方案 


使 用 LINQ 查询 类 型 接口 信息 ， 并 执行 丰富 的 查找 条 件 。 例 4-2 中 所 示 的 方法 将 演示 LINQ 
可 以 执行 的 一 种 复杂 的 查找 。 


例 4-2: 对 类 型 上 的 接口 执行 复杂 的 查找 
// 设置 要 查找 的 接口 
Type[] interfaces = { 
typeof (System. ICloneable), 
typeof (System.Collections.ICollection), 
typeof (System. IAppDomainSetup) }; 























// 设置 要 检查 的 类 型 
Type searchType = typeof(System.Collections.ArrayList); 


var matches = from t in searchType.GetInterfaces() 
join s in interfaces on t equals s 
select s; 


Console.WriteLine("Matches found:"); 
foreach (Type match in matches) 
Console.WriteLine(match.ToString()); 


例 4-2 中 的 代码 搜索 ;interfaces 数组 中 包含 的 三 个 接口 中 被 System.CoLLections . 
ArrayList 类 型 实现 的 任意 接口 。 这 是 通过 使 用 LINQ 来 连接 类 型 实现 的 接口 集合 及 
interfaces 数组 来 实现 的 。 

GetInterface 方法 只 按 名称 查 找 接口 (使 用 区 分 大 小 写 或 不 区 分 大 小 写 的 查找 )， 
GetInterfaces 方法 则 返回 特定 类 型 上 实现 的 所 有 接口 的 数组 。 要 执行 一 个 更 特定 的 查询 
[例如 ， 找 定义 具有 特定 签名 的 方法 的 接口 ， 或 者 实现 从 全 局 程序 集 缓存 (GAC， 其 中 存 
储 公 共 程 序 集 ) 加 载 的 接口 ]， 你 需要 使 用 一 种 不 同 的 机 制 ， 例 如 LINQ。LINQ 为 查找 接 
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口 提供 了 一 种 更 灵活 、 更 高 级 的 能 力 ， 而 不 需要 创建 自己 的 接口 查找 引擎 。 这 种 能 力 可 以 
用 于 加 载 特 定 接口 的 程序 集 ， 从 现 有 程序 集中 生成 代码 其 至 用 作 一 种 逆向 工程 工具 。 








4.11.3. iit 
使 用 LINQ 来 查找 在 某 种 类 型 上 实现 的 接口 可 以 有 许多 种 方式 。 下 面 只 列 出 了 可 以 执行 的 

















其 他 少数 几 种 查找 方式 。 
查找 在 特定 命名 空间 (在 本 例 中 是 System. Collections 命名 空间 ) 内 定义 的 所 有 实现 的 
接口 。 
var collectionsInterfaces = from type in searchType.GetInterfaces() 


where type.Namespace == "System.Collections" 
select type; 


查找 包含 返回 一 个 Int32 值 Add 方法 的 所 有 实现 的 接口 。 
var addInterfaces = from type in searchType.GetInterfaces() 
from method in type.GetMethods() 
where (method.Name -- "Add") && 
(method.ReturnType -- typeof(int)) 
select type; 


查找 从 GAC 加 载 的 所 有 实现 的 接口 。 
var gacInterfaces = from type in searchType.GetInterfaces() 
where type.Assembly.GlobalAssemblyCache 
select type; 


查找 版 本 号 为 4.0.0.0 的 程序 集 内 定义 的 所 有 实现 的 接口 。 
var versionInterfaces = from type in searchType.GetInterfaces() 

where type.Assembly.GlobalAssemblyCache && 
type.Assembly.GetName().Version.Major == 4 && 
type.Assembly.GetName().Version.Minor == 0 && 
type.Assembly.GetName().Version.Build == 0 && 
type.Assembly.GetName().Version.Revision == 0 

select type; 





43114 ”参考 


MSDN 文档 中 的 “lambda 





RIAIN (CH 编程 指南 )” 和 “where 关键 字 [LINQ] (C#)” 





主题 。 


4.12 ”使 用 lambda 表 达 式 


4.12.1 问题 
CH 中 包含 一 个 称 为 lambda 表达 式 的 特性 。 虽 然 可 以 将 lambda 表达 式 视 为 降低 定义 匿名 方 
法 难度 的 语法 糖 ， 但 是 也 要 理解 它们 在 日 常 编程 任务 中 的 所 有 不 同 应 用 以 及 这 些 应 用 带 来 














4.12.2 解决 方案 


TS 








编译 器 可 以 从 开发 人 员 创建 的 方法 中 实现 lambda 表达 式 。lambda 表达 式 可 能 具有 以 下 两 
个 正 交 特 征 。 





。 参数 列表 可 以 是 显 式 或 隐 式 类 型 。 
。 表达 式 体 可 以 是 表达 式 或 语句 块 。 
让 我 们 从 使 用 委托 的 普通 方式 开始 。 首 先 ， 将 声明 一 种 委托 类 型 (此 处 是 Dowork) ， 然 
后 将 创建 它 的 一 个 实例 (如 workItout 方法 中 所 示 )。 声 明 委 托 的 实例 要 求 指定 当 调 
用 委托 时 要 执行 的 方法 ， 这 里 已 经 连接 了 DoWorkMethodImpl 方法 。 调 用 委托 ， 并 通过 
DoWorkMethodImpl 方法 把 文本 写 到 控制 台 。 

class OldWay 


( 


} 





// 声明 委托 
delegate int DoWork(string work); 


// 编写 一 个 方法 以 创建 委托 实例 并 调用 委托 
public void WorkItOut() 


// 声明 实例 

DoWork dw = new DoWork(DoWorkMethodImpl); 
// 调用 委托 

int i = dw("Do work the old way"); 


} 


// 编写 一 个 委托 将 连接 的 方法 ,具有 相同 的 签名 
// 因此 当 委托 被 调用 时 , 此 方法 被 调用 
public int DoWorkMethodImpl(string s) 
{ 




















Console.WriteLine(s); 
return s.GetHashCode(); 








lambda 表达 式 人 允许 建立 在 调用 委托 时 要 运行 的 代码 ， 但 是 不 必 给 委托 提供 一 个 命名 的 正 
式 方 法 声明 。 声 明 的 方法 是 无 名 的 ， 并 且 在 外 层 方法 的 作用 域 上 关闭 。 例 如 ， 可 以 使 用 
lambda 表达 式 编 写 前 面 的 代码 。 


class LambdaWay 


( 





// 声明 委托 
delegate int DoWork(string work); 


// 编写 一 个 方法 以 创建 委托 实例 并 调用 委托 
public void WorkItOut() 


// 声明 实例 

DoWork dw = s => 

{ 
Console.WriteLine(s); 
return s.GetHashCode(); 
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a 
// 调用 委托 


int i = dw("Do some inline work"); 
} 
} 
我 们 注意 到 ， 这 段 代 码 中 没有 使 用 名 为 DeWorkMethodImpl 的 方法 ， 而 是 使 用 => 运算 符 从 
内 联 到 DoWork 委托 的 那个 方法 指派 代码 ， 这 种 指派 方法 如 下 所 示 。 
DoWork dw = s => 


{ 
Console.WriteLine(s); 
return s.GetHashCode(); 
F 
你 还 提供 了 Dowork 委托 需要 的 参数 (string)， 并且 代码 根据 委托 的 需要 返回 一 个 int 
(s.GetHashCode())。 在 建立 lambda 表达 式 时 ， 代 码 必 须 与 委托 签名 匹配 ， 否 则 将 得 到 一 
个 编译 器 错误 。 
“匹配 ”有 以 下 几 个 含义 。 
。 如 果 显 式 类 型 化 ，lambda 参数 必须 与 委托 参数 精确 匹配 。 如 果 隐 式 类 型 化 ，lambda 参 
数 就 会 获得 委托 参数 类 型 。 
e lambda 体 必 须 是 被 赋予 参数 类 型 的 合法 表达 式 或 语句 块 。 
e lambda 的 返回 类 型 必须 可 以 隐 式 转换 成 委托 的 返回 类 型 。 它 不 需要 精确 匹配 。 


还 可 以 用 另 一 种 方式 建立 委托 ， 即 通过 委托 推断 来 完成 。 委 托 推 断 允 许 把 方法 名 直接 
赋予 委托 实例 ， 而 不 必 编 写 用 于 创建 新 委托 对 象 的 代码 。 在 底层 ，C# 实际 上 会 编写 用 
于 创建 委托 对 象 的 IL， 但 是 此 处 不 需要 显 式 地 这 样 做。 使 用 委托 推断 而 不 是 到 处 书写 
new[DelegateType]([MethodName]) 有 助 于 使 在 使 用 委托 时 涉及 的 代码 保持 整洁 ， 如 下 
所 示 。 


class DirectAssignmentWay 


{ 




















// 声明 委托 


delegate int DoWork(string work); 


// 编写 一 个 方法 以 创建 委托 实例 并 调用 委托 
public void WorkItOut() 
{ 

// 声明 实例 并 指派 方法 

DoWork dw = DoWorkMethodImpl; 

// 调用 委托 

int i = dw("Do some direct assignment work"); 
} 
// 编写 一 个 委托 将 连接 的 方法 ,具有 相同 的 签名 
// 因此 当 委托 被 调用 时 ,此 方法 被 调用 
public int DoWorkMethodImpl(string s) 
{ 








Console.WriteLine(s); 
return s.GetHashCode(); 





我 们 广 意 到 ， 赋 予 DoWork 委托 实例 dw 的 全 部 内 容 只 有 方法 名 DoworkMethodImpL， 不 像 旧 
AY CH 代码 那样 还 有 new Dowork(DoworkMethodImpL) 调用 。 











记 住 ， 底 层 委托 包装 器 并 没有 消失 ;委托 推断 只 是 通过 隐藏 它 的 一 些 内 容 简 
化 一 下 语法 。 








此 外 ， 还 可 以 建立 接受 泛 型 类 型 参数 的 lambda 表达 式 ， 用 于 泛 型 委托 ， 如 同 此 处 的 
GenericWay 类 中 所 示 。 


class GenericWay 


// 编写 一 个 方法 以 创建 委托 实例 并 调用 委托 
public void WorkItOut() 
{ 


Func<string, string> dwString = s => 


Console.WriteLine(s); 
return s; 


J; 
// 调用 string 委 托 


string retStr = dwString("Do some generic work"); 


Func<int, int» dwInt = i => 
{ 
Console.WriteLine(i); 
return i; 


J; 


// 调用 int 委 托 
int j = dwInt(5); 


4.12.3 讨论 


lambda 表达 式 的 一 个 有 用 之 处 是 外 层 变量 的 概念 。 外 层 变量 的 官方 定义 是 ， 任 何 具 有 包含 
lambda 表达 式 的 作用 域 的 局 部 变量 、 值 参数 或 参数 数组 。 


这 意味 着 ， 在 lambda 表达 式 的 代码 内 ， 可 以 接触 到 该 方法 的 作用 域外 面 的 变量 。 有 一 个 
“捕获 ”变量 的 概念 ， 捕 获 发 生 在 lambda 表达 式 实际 引用 外 层 变量 之 一 时 。 在 下 面 的 示例 
HH, lambda 表达 式 将 捕获 count 变量 并 递增 它 。count 变量 不 是 lambda 表达 式 的 一 部 分 ， 
而 是 外 层 作用 域 的 一 部 分 。 它 被 递增 ， 然 后 返回 递增 后 的 值 并 求 和 。 


public void SeeOuterWork() 
{ 


int count = 0; 
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int total = 0; 
Func<int> countUp = () => count++; 
for (int i = 0; i < 10; i++) 
total += countUp(); 
Debug.WriteLine($"Total = {total}"); 
} 


捕获 操作 实际 的 作用 是 延长 外 层 变量 的 生存 期 ， 使 之 与 代表 lambda 表达 式 的 底层 委托 实 
例 的 生存 期 保持 一 致 。 这 应 该 促使 你 小 心 使 用 从 lambda 表达 式 内 接触 到 的 内 容 。 它 可 能 
会 导致 一 些 对 象 生 存 的 时 间 比 最 初 计 划 的 要 长 许多 。 在 lambda 表达 式 中 使 用 外 层 变 

垃圾 收集 器 在 以 后 才 会 有 机 会 清理 这 些 变量 。 捕 获 外 层 变 量 对 垃圾 收集 器 有 另 一 种 作用 ， 
当 捕 获 局 部 变量 或 值 参 数 时 ， 不 再 把 它们 视 为 固定 的 ， 而 认为 它们 是 活动 的 。 因 此 在 使 用 
这 些 变量 之 前 ， 不 安全 的 代码 必须 使 用 fixed 关键 字 固 定 它们 。 


外 层 变 量 可 以 影响 编译 器 为 lambda 表达 式 生 成 内 部 二 的 方式 。 如 果 lambda 表达 式 使 用 了 
外 层 变 量 ， 就 把 该 lambda 表达 式 生 成 为 租 套 类 的 一 个 私有 方法 。 如 果 lambda 表达 式 没 有 使 
用 外 层 变 量 ， 则 将 其 生成 为 声明 它 的 类 中 的 另 一 个 私有 方法 。 如 果 外 层 方法 是 静态 的 ， 那 么 
lambda 表达 式 就 不 能 通过 this 关键 字 访 问 实 例 成 员 ， 因 为 租 套 类 也 会 被 生成 为 静态 的 。 

有 两 类 lambda 表达 式 : 表达 式 (expression) lambda 和 语句 (statement) lambda。 表 达 式 
lambda 不 带 参 数 ， 只 简单 地 递增 表达 式 中 的 count 变量 。 


int count = 0; 
Func<int> countUp = () => count++; 


1&5) lambda 具有 封闭 在 花 括号 中 的 主体 ， 可 以 包含 任意 数量 的 语句 。 


Func<int, int> dwInt = i => 






























































Console.WriteLine(i); 
return i; 


h 





KF lambda 表达 式 要 记 住 的 最 后 几 点 包括 以 下 这 些 。 
它们 不 能 使 用 break, goto 或 continue 从 lambda 表达 式 跳 到 lambda 表达 
式 块 外 面 的 目标 。 

能 在 lambda 表达 式 内 执行 不 安全 的 代码 。 
不 能 在 is 运算 符 的 左边 使 用 lambda 表达 式 。 
因为 lambda 表达 式 是 匿名 方法 的 超 集 ， 所 以 适用 于 匿名 方法 的 所 有 限制 也 
适用 于 lambda 表达 式 。 

















4.12.4 参考 
MSDN 文档 中 的 “lambda 表达 式 (Ci 编程 指南 )” 主 题 








4.13 在 lambda 表 达 式 中 使 用 不 同 的 参数 修饰 符 


4.13.1 问题 


你 知道 可 以 把 参数 传递 给 lambda 表达 式 ， 但 是 还 需要 确定 可 以 对 它们 使 用 哪些 有 效 的 参 
数 修饰 符 。 


4.13.2 ”解决 方案 


lambda 表达 式 可 以 在 它们 的 参数 列表 中 使 用 out 和 ref 参数 修饰 符 ， 但 是 不 能 使 用 params 
修饰 符 。 不 过 ， 这 不 会 妨碍 利用 其 中 的 任何 修饰 符 来 创建 委托 。 


// 声明 out 委 托 


delegate int DoOutWork(out string work); 





// 声明 ref 委 托 


delegate int DoRefWork(ref string work); 


// 声明 parans 委 托 

delegate int DoParamsWork(params object[] workItems); 
即使 在 定义 DoParamsWork 委托 时 对 参数 使 用 params 关键 字 ， 仍 然 可 以 把 它 用 作 lambda 表 
达 式 的 类 型 ， 稍 后 就 会 看 到 这 一 点 。 为 了 使 用 Do0utwork 委托 ， 可 以 使 用 out 关键 字 创 建 
一 个 内 联 lambda 表达 式 ， 并 把 它 赋 予 DoOutWork 委托 实例 。 在 lambda 表达 式 体 内 ， 首 先 
给 out 变量 赋值 (因为 通过 定义 为 out 参数 ， 它 并 疫 有 初始 值 ) ， 把 它 写 到 控制 台 ， 并 返回 
字符 串 散 列 代码 。 注 意 在 参数 列表 中 ， 必 须 提 供 s 的 类 型 ( 即 string)， 因 为 无 法 推断 标 
WA out 或 ref 关键 字 的 变量 的 类 型 。 编 译 器 不 会 推断 out 或 ref 变量 ， 以 保留 调用 站 点 
和 参数 声明 站 点 的 类 型 表示 ， 从 而 帮助 开发 人 员 清 楚 地 推断 这 些 变量 的 可 能 赋值 。 


|] 声明 实例 并 赋予 方法 
DoOutWork dow = (out string s) => 









































{ 
s = "WorkFinished"; 
Console.WriteLine(s); 
return s.GetHashCode(); 
3 
要 运行 lambda 表达 式 代码 ， 可 以 用 一 个 out 参数 调用 委托 ， 然 后 把 结果 输出 到 控制 台 。 
// 调用 委托 











string work; 
int i = dow(out work); 
Console.WriteLine(work); 


为 了 在 lambda 表达 式 中 使 用 ref 参数 修饰 符 ， 可 以 创建 一 个 内 联 方法 ， 利 用 ref 参数 挂 接 
到 DoRefWork 委托 。 在 该 方法 中 ， 输 出 变量 的 原始 值 ， 重 新 赋值 ， 并 且 获 得 新 值 的 散 列 代 
码 。 记 住 ， 与 out 关键 字 一 样 ， 在 参数 列表 中 必须 提供 s 的 类 型 〈 即 string), ， 因 为 无 法 
推断 标记 有 ref 关键 字 的 变量 的 类 型 。 
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// 声明 实例 并 赋予 方法 
DoRefWork drw = (ref string s) => 


t 
Console.WriteLine(s); 
s = "WorkFinished"; 
return s.GetHashCode(); 
IE 


要 运行 lambda 表达 式 ， 给 字符 串 work 赋值 ， 然 后 将 其 作为 ref 参数 传递 给 实例 化 的 
DoRefWork 委托 。 当 委托 调用 返回 时 ， 输 出 work 字符 串 的 新 值 。 





// 调用 委托 

work = "WorkStarted"; 

i = drw(ref work); 
Console.WriteLine(work) ; 





虽然 可 以 利用 params 修饰 符 声 明 委 托 ， 但 是 不 能 在 参数 列表 中 利用 params 关键 字 使 用 
lambda 表达 式 挂 接 委 托 。 如 果 试 图 这 样 做 ， 编 译 器 将 在 DoParamsWork 行 上 显示 编译 错误 : 
“CS1670 params is not valid in this context” , 




















//// 作 为 Lambda 来 使 用 ,将 会 得 到 
////CS1670 "params is not valid in this context" 
//DoParamsWork dpwl = (params object[] workItems) => 


IH 

// foreach (object o in workItems) 

// t 

// Console.WriteLine(o.ToString()); 
/本 

// return workItems.GetHashCode(); 

IT); 


即使 党 试 使 用 匿名 方法 代替 lambda 表达 式 执行 该 操作 ， 仍 然 不 能 在 参数 列表 中 利用 
params 关键 字 挂 接 委 托 。 如 果 试 图 这 样 做 ， 编 译 器 仍然 将 在 DoParamsWork 行 上 显示 编译 错 


im: 


不 过 

















“CS1670 params is not valid in this context” , 














// 作 为 匿名 方法 来 使 用 ,将 会 得 到 
//CS1670 "params is not valid in this context" 
//DoParamsWork dpwa = delegate (params object[] workItems) 





IIA 

// foreach (object o in workItems) 

|| t 

// Console.WriteLine(o.ToString()); 
// 3} 

// return workItems.GetHashCode(); 

IT); 


， 可 以 省 略 params 关键 字 ， 仍 然 为 委托 建立 lambda 表达 式 ， 如 下 所 示 。 


// 我 们 能 做 的 是 省 略 params 关 键 字 


DoParamsWork dpw = workItems => 


t 
foreach (object o in workItems) 
Console.WriteLine(o.ToString()); 
return workItems.GetHashCode(); 
IE 





我 们 注意 到 ， 尽 管 从 lambda 表达 式 中 删除 了 params 关键 字 ， 但 这 不 会 阻止 你 使 用 相同 的 
语法 。params 关键 字 存在 于 委托 类 型 上 ， 因 此 可 以 像 下 面 这 样 调用 它 。 


int i = dpw("Hello", "42", "bar"); 


这 说 明 可 以 把 lambda 表达 式 绑 定 到 使 用 params 声明 的 委托 上 。 一 旦 执行 了 该 操作 ， 就 可 
以 调用 lambda 表达 式 ， 按 你 所 期 望 的 那样 传人 任意 数量 的 参数 。 


4.13.3 讨论 


lambda 表达 式 不 能 访问 外 部 作用 域 的 ref 或 out 参数 。 这 意味 着 定义 为 包含 方法 的 一 部 分 
的 任何 out 或 ref 变量 都 禁止 在 lambda 表达 式 体内 部 使 用 。 


public void TestOut(out string outStr) 




































































{ 
// 声明 实例 
DoWork dw = s => 
{ 
Console.WriteLine(s); 
// 导致 错误 CS1628: 
// "Cannot use ref or out parameter 'outStr' inside an 
// anonymous method, lambda expression, or query expression" 
outStr = s; 
return s.GetHashCode(); 
IE 
// 调用 委托 
int i = dw("DoWorkMethodImpli"); 
} 
public void TestRef(ref string refStr) 
{ 
// 声明 实例 
DoWork dw = s => 
{ 
Console.WriteLine(s); 
// 导致 错误 CS1628; 
// "Cannot use ref or out parameter 'refStr' inside an 
// anonymous method, lambda expression, or query expression" 
refStr = s; 
return s.GetHashCode(); 
ME 
// 调用 委托 
int i = dw("DoWorkMethodImpli"); 
} 
非常 有 趣 的 是 ，lambda 表达 式 可 以 访问 带 有 params 修饰 符 的 外 层 变 量 。 
// 声明 委托 


delegate int DoWork(string work); 
public void TestParams(params string[] items) 


// 声明 实例 


DoWork dw = s => 
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{ 
Console.WriteLine(s); 
foreach (string item in items) 

Console.WriteLine(item); 

return s.GetHashCode(); 

J; 

// 调用 委托 

int i = dw("DoWorkMethodImpli1"); 

} 


由 于 params 修饰 符 可 以 给 调用 站 点 提供 好 处 〈 因 此 编译 器 知道 使 之 成 为 一 个 支持 可 变 长 度 
的 参数 列表 的 方法 调用 ) ， 并 且 它 永远 不 会 直接 调用 lambda 表达 式 (总 是 通过 委托 调用 )， 

那么 出 于 给 调用 站 点 提供 好 处 的 目的 对 lambda 表达 式 进 行 某 种 修饰 就 显得 毫 无 意义 一 一 
毕竟 没有 调用 站 点 。 因 此 ， 不 能 对 lambda 表达 式 使 用 params 关键 字 是 无 关 紧 要 的 。 对 于 
lambda 表达 式 ， 调 用 站 点 总 是 通过 委托 调用 它 ， 因 此 委托 是 否 具有 params 关键 字 才 是 要 
紧 的 事 。 


4.13.4 ”参考 


范例 1.17 (BN 1.17 节 );MSDN 文档 中 的 “CS1670”“CS1525”“CS1628”“out”“ref”“para- 
ms” 和 “System.ParamArrayAttribute” 主 题 。 


4.14 用 并 行 来 加 速 LINQ 操 作 


4.14.1 问题 
一 个 执行 代价 高 昂 操 作 的 LINQ 查询 拖 慢 了 整个 处 理 ， 你 希望 能 提升 它 的 速度 。 


4.14.2 解决 方案 

使 用 并 行 LINQ (parallel LINQ, PLINQ) 来 利用 机 器 的 全 部 性 能 更 快 地 处 理 查询 。 

要 演示 这 一 点 ， 让 我 们 来 考虑 一 下 Brooke 和 Katie 的 困境 。Brooke 和 Katie 正 一 起 忙于 一 
本 毫 饪 手册 ， 他 们 需要 评估 所 有 章节 中 的 所 有 食谱 。 因 为 有 非常 多 的 食谱 ， 所 以 他 们 想 要 
将 食谱 基本 的 验证 步骤 交 出 去 ， 然 后 由 Brooke 或 者 Katie 作为 主编 对 每 个 食谱 进行 最 后 的 
完善 工作 。 

每 个 Chapter 包含 一 些 Recipe, Recipe 的 验证 步骤 包括 以 下 四 个 。 

(1) 阅读 食谱 的 文本 作为 前 提 。 

(2) 检查 食谱 的 原料 和 份量 。 

(3) 准备 食谱 ， 将 食谱 的 每 个 难度 级 别 品尝 一 次 。 

(4) 由 Brooke 或 Kaite 完成 最 终 的 编辑 步骤 。 

如 果 食 谱 评 估 的 任何 阶段 未 能 通过 ， 这 一 阶段 就 需要 重 做 ， 品 尝 阶 段 除外 。 如 果 食 谱 未 能 
通过 品 党 阶段， 需要 从 头 开 始 。 
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要 使 用 常规 的 LINQ 来 处 理 RecipeChapter 的 集合 (例子 中 的 chapters) ， 可 以 使 用 以 下 
语句 。 

chapters.Select(c => TimedEvaluateChapter(c, rnd)).ToList(); 
TimedEvaluateChapter 方法 对 RecipeChapter 和 其 中 的 所 有 Recipe 进行 评估 ， 同 时 对 评估 


过 程 计 时 。 对 RecipeChapter 中 的 每 一 个 Recipe 都 调用 一 次 EvaluateRecipe 以 执行 Recipe 
的 检验 步骤 。 


private static RecipeChapter TimedEvaluateChapter(RecipeChapter rc, Random rnd) 


( 





Stopwatch watch - new Stopwatch(); 
LogOutput($"Evaluating Chapter {rc}"); 
watch.Start(); 
foreach (var r in rc.Recipes) 

EvaluateRecipe(r, rnd); 
watch.Stop(); 
LogOutput($"Finished Evaluating Chapter {rc}"); 
return rc; 


} 
为 了 更 快速 地 处 理 Recipe， 我 们 在 调用 Select 为 每 一 个 RecipeCchapter 调用 
TimedEvaluateChapter 之 前 ， 添 加 了 对 AsParallel 扩展 方法 的 调用 。 
chapters.AsParallel().Select(c => TimedEvaluateChapter(c, rnd)).ToList(); 
运行 结果 取决 于 你 的 硬件 ， 但 下 面 的 结果 记录 了 一 次 先 运行 常规 LINQ， 然 后 运行 PLINQ 
的 计时 。 


Full Chapter Evaluation with LINQ took: 00:01:19.1395258 
Full Chapter Evaluation with PLINQ took: 00:00:25.1708103 























414.3 讨论 


当 使 用 PLINQ 时 ， 要 记得 的 首要 大 事 是 并 行 处 理 的 工作 单元 数量 要 足够 大 ， 以 抵消 并 行 
的 成 本 。 并 行 操作 有 一 些 额 外 的 设置 和 拆 解 成 本 (例如 将 数据 集 分 区 )， 如 果 数 据 集 大 小 
或 者 在 每 个 成 员 上 的 操作 代价 并 不 高 ， 将 不 足以 从 并 行 技 术 中 受益 ， 实 际 性 能 可 能 会 更 差 
一 些 。 如 果 PLINQ 确定 它 并 不 能 高 效 地 将 查询 并 行 ， 它 将 会 顺序 处 理 查询 。 当 此 情况 发 
生 时 ， 根 据 你 的 特定 情形 (WithExecutionMode、WithDegree0fParallelism)， 可 以 使 用 另 
外 一 些 额 外 的 方法 进行 调整 。 

与 所 有 的 工程 问题 一 样 ， 测 量 你 的 结果 是 理解 是 否 有 所 提升 的 关键 。 考 虑 到 这 一 点 ， 我 们 
创建 了 TimedEvaluateChapter 方法 以 在 Select 语句 中 调用 。 


chapters.AsParallel().Select(c => TimedEvaluateChapter(c, rnd)).ToList(); 


TimedEvaluateChapter 对 评估 RecipeChapter 中 所 有 Recipe 的 过 程 进行 了 计时 ， 调 用 
了 Stopwatch.Start 和 Stopwatch.Stop 实现 计时 值 的 包装 。 注 意 ， 如 果 你 没有 调用 
Stopwatch.Reset 就 重新 启动 了 Stopwatch， 那 么 计时 结果 将 累加 到 Stopwatch 中 已 有 的 值 
上 ， 你 也 许 就 得 到 比 预期 更 大 一 些 的 值 。 
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private static RecipeChapter TimedEvaluateChapter(RecipeChapter rc, Random rnd) 
{ 

Stopwatch watch = new Stopwatch(); 

LogOutput($"Evaluating Chapter {rc}"); 

watch.Start(); 

foreach (var r in rc.Recipes) 

EvaluateRecipe(r, rnd); 

watch.Stop(); 

LogOutput($"Finished Evaluating Chapter {rc}"); 

return rc; 


} 
EvaluateRecipe 递归 执行 每 个 食谱 的 验证 步骤 ， 直 到 通过 了 Brooke 和 Katie 的 最 终 编 辑 。 
调用 Thread. Sleep 以 模拟 每 个 步骤 的 工作 。 


private static Recipe EvaluateRecipe(Recipe r, Random rnd) 


{ 
// 食 谱 编 辑 步 又 
if (!r.TextApproved) 
{ 











// 阿 读 食谱 以 确定 是 否 合理 
Thread.Sleep(50); 
int evaluation = rnd.Next(1, 10); 


// 7 表示 不 合理 ,不 批准 ， 























// 打 回 重 做 
if (evaluation == 7) 
{ 
LogOutput($"{r} failed the readthrough! Reworking..."); 
} 
else 


r.TextApproved = true; 
return EvaluateRecipe(r, rnd); 

















} 
else if (!r.IngredientsApproved) 
{ 
// 检 查 原料 和 份量 
Thread.Sleep(100) ; 
int evaluation = rnd.Next(1, 10); 
// 3 表示 原料 或 份量 不 对 ， 
// 打 回 重 做 
if (evaluation == 3) 
{ 
LogOutput($"{r} had incorrect measurements! Reworking..."); 
else 
r.IngredientsApproved = true; 
return EvaluateRecipe(r, rnd); 
} 
else if (r.RecipeEvaluated != r.Rank) 
{ 


// 准 备 食谱 和 品尝 

Thread.Sleep(50 * r.Rank); 

int evaluation = rnd.Next(1, 10); 
// 4 表示 尝 起 来 不 对 , 打 回 重 做 


if (evaluation == 4) 





limi 








r.TextApproved = false; 
r.IngredientsApproved = false; 
r.RecipeEvaluated = 0; 
LogOutput($"{r} tasted bad! Reworking..."); 
} 
else 
r.RecipeEvaluated++; 
return EvaluateRecipe(r, rnd); 


else 


// 最 终 的 编辑 阶段 (Brooke 或 Katie) 
Thread.Sleep(50 * r.Rank); 

int evaluation = rnd.Next(1, 10); 
// 1 表示 食谱 并 不 完善 , 打 回 重 做 

if (evaluation == 1) 


{ 








LH 











r.TextApproved - false; 
r.IngredientsApproved - false; 
r.RecipeEvaluated - 0; 
LogOutput($"{r} failed final editing! Reworking..."); 
return EvaluateRecipe(r, rnd); 
} 
else 
{ 
r.FinalEditingComplete = true; 
LogOutput($"{r} is ready for release!"); 
} 
} 
return r; 


} 
下 列 是 RecipeChapter 和 Recipe 类 的 定义 ， 用 于 帮助 Brooke 和 Katie 评估 所 有 食谱 。 


public class RecipeChapter 





{ 

public int Number { get; set; } 

public string Title { get; set; } 

public List<Recipe> Recipes { get; set; } 

public override string ToString() => $"{Number} - {Title}"; 
} 


public class Recipe 

{ 
public RecipeChapter Chapter { get; set; } 
public string MainIngredient { get; set; } 
public int Number { get; set; } 
public bool TextApproved { get; set; } 
public bool IngredientsApproved { get; set; } 


{|| <summary> 
// Recipe 应 该 评估 的 次 数 与 食谱 的 Rank 值 相同 
/// </summary> 
public int RecipeEvaluated { get; set; } 
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} 


public bool FinalEditingComplete { get; set; } 
public int Rank { get; set; } 


public override string ToString() => 
$"{Chapter.Number}.{Number} ({Chapter. Title}: {MainIngredient})"; 


LINQ 的 输出 样 例如 下 所 示 ， 它 顺序 地 处 理 集合 。 


Running Cookbook Evaluation 
Evaluating Chapter 1 - Soups 
1.1 


HB HB H HB HB H B HH B PPP PE 


\D 00-009 U1 3$ I» 4» 0 UU 2 


(Soups:Sprouts, Mung Bean) is ready for release! 
(Soups:Potato Bread) is ready for release! 

(Soups:Chicken Liver) tasted bad! Reworking... 
(Soups:Chicken Liver) is ready for release! 
(Soups:Cherimoya) tasted bad! Reworking... 
(Soups:Cherimoya) had incorrect measurements! Reworking... 
(Soups:Cherimoya) is ready for release! 
(Soups:High-Protein Bread) is ready for release! 
(Soups:Flat Bread) failed the readthrough! Reworking... 
(Soups:Flat Bread) is ready for release! 
(Soups:Pomegranate) is ready for release! 

(Soups:Carissa, Natal Plum) had incorrect measurements! Reworking... 
(Soups:Carissa, Natal Plum) is ready for release! 
(Soups:Ideal Flat Bread) is ready for release! 


.10 (Soups:Banana Bread) tasted bad! Reworking... 
.10 (Soups:Banana Bread) is ready for release! 


Finished Evaluating Chapter 1 - Soups 
Evaluating Chapter 2 - Salads 


NNNNNNNNNNNNNNNN DN PN 
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(Salads:Caraway) tasted bad! Reworking... 
(Salads:Caraway) tasted bad! Reworking... 
(Salads:Caraway) had incorrect measurements! Reworking... 
(Salads:Caraway) is ready for release! 

(Salads:Potatoes, Red) had incorrect measurements! Reworking... 
(Salads:Potatoes, Red) tasted bad! Reworking... 
(Salads:Potatoes, Red) is ready for release! 
(Salads:Lemon) is ready for release! 

(Salads:Cream cheese) is ready for release! 
(Salads:Artichokes, Domestic) is ready for release! 
(Salads:Grapefruit) is ready for release! 
(Salads:Lettuce, Iceberg) is ready for release! 
(Salads:Fenugreek) is ready for release! 

(Salads:Ostrich) is ready for release! 


.10 (Salads:Brazil Nuts) tasted bad! Reworking... 

.10 (Salads:Brazil Nuts) had incorrect measurements! Reworking... 
.10 (Salads:Brazil Nuts) tasted bad! Reworking... 

.10 (Salads:Brazil Nuts) is ready for release! 


Finished Evaluating Chapter 2 - Salads 

Evaluating Chapter 3 - Appetizers 

3.1 (Appetizers:Loquat) tasted bad! Reworking... 

3.1 (Appetizers:Loquat) had incorrect measurements! Reworking... 
3.1 (Appetizers:Loquat) tasted bad! Reworking... 

3.1 (Appetizers:Loquat) is ready for release! 
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(Appetizers:Bergenost) is ready for release! 

(Appetizers:Tomato Red Roma) had incorrect measurements! Reworking... 
(Appetizers:Tomato Red Roma) tasted bad! Reworking... 
(Appetizers:Tomato Red Roma) tasted bad! Reworking... 
(Appetizers:Tomato Red Roma) is ready for release! 
(Appetizers:Guava) failed final editing! Reworking... 
(Appetizers:Guava) is ready for release! 

(Appetizers:Squash Flower) is ready for release! 
(Appetizers:Radishes, Red) is ready for release! 
(Appetizers:Goose Liver) tasted bad! Reworking... 
(Appetizers:Goose Liver) had incorrect measurements! Reworking... 
(Appetizers:Goose Liver) is ready for release! 

(Appetizers:Okra) had incorrect measurements! Reworking... 
(Appetizers:Okra) is ready for release! 

(Appetizers:Borage) is ready for release! 


.10 (Appetizers:Peppers) is ready for release! 


Finished Evaluating Chapter 3 - Appetizers 
Evaluating Chapter 4 - Entrees 
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(Entrees: 
(Entrees: 
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(Entrees: 
(Entrees: 
(Entrees: 
(Entrees: 
.10 (Entrees:Prosciutto) is ready for release! 


Plantain) is ready for release! 

Pignola (Pine)) is ready for release! 

Potatoes, Gold) is ready for release! 

Ribeye) failed the readthrough! Reworking... 

Ribeye) is ready for release! 

Sprouts, Mung Bean) failed the readthrough! Reworking... 
Sprouts, Mung Bean) had incorrect measurements! Reworking... 
Sprouts, Mung Bean) failed final editing! Reworking... 
Sprouts, Mung Bean) is ready for release! 

Squash) had incorrect measurements! Reworking... 

Squash) is ready for release! 

Squash, Winter) tasted bad! Reworking... 

Squash, Winter) is ready for release! 

Corn, Blue) is ready for release! 

Snake) had incorrect measurements! Reworking... 

Snake) tasted bad! Reworking... 

Snake) tasted bad! Reworking... 

Snake) is ready for release! 


Finished Evaluating Chapter 4 - Entrees 

Evaluating Chapter 5 - Desserts 

5.1 (Desserts:Mushroom, White, Silver Dollar) tasted bad! Reworking... 
5.1 (Desserts:Mushroom, White, Silver Dollar) had incorrect measurements! 
Reworking... 
5.1 (Desserts:Mushroom, White, Silver Dollar) tasted bad! Reworking... 
5.1 (Desserts:Mushroom, White, Silver Dollar) tasted bad! Reworking... 
5.1 (Desserts:Mushroom, White, Silver Dollar) had incorrect measurements! 
Reworking... 
(Desserts:Mushroom, White, Silver Dollar) is ready for release! 
(Desserts:Eggplant) is ready for release! 

(Desserts:Asparagus Peas) tasted bad! Reworking... 
(Desserts:Asparagus Peas) failed the readthrough! Reworking... 
(Desserts:Asparagus Peas) failed the readthrough! Reworking... 
(Desserts:Asparagus Peas) is ready for release! 
(Desserts:Squash, Kabocha) failed the readthrough! Reworking... 
(Desserts:Squash, Kabocha) tasted bad! Reworking... 
(Desserts:Squash, Kabocha) is ready for release! 


1 
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(Desserts: 
(Desserts: 
(Desserts: 
(Desserts: 
(Desserts: 
(Desserts: 
(Desserts: 
(Desserts: 
(Desserts: 
(Desserts: 
.10 (Desserts:Opossum) had incorrect measurements! Reworking... 
.10 (Desserts:Opossum) is ready for release! 


Sprouts, Radish) is ready for release! 

Mushroom, Black Trumpet) is ready for release! 

Tea Cakes) tasted bad! Reworking... 

Tea Cakes) tasted bad! Reworking... 

Tea Cakes) failed the readthrough! Reworking... 

Tea Cakes) is ready for release! 

Blueberries) had incorrect measurements! Reworking... 
Blueberries) tasted bad! Reworking... 

Blueberries) is ready for release! 

Sago Palm) is ready for release! 


Finished Evaluating Chapter 5 - Desserts 

Evaluating Chapter 6 - Snacks 

(Snacks:Cheddar) tasted bad! Reworking... 

(Snacks:Cheddar) is ready for release! 

(Snacks:Melon, Bitter) is ready for release! 
(Snacks:Scallion) is ready for release! 

(Snacks:Squash Chayote) failed final editing!  Reworking... 
(Snacks:Squash Chayote) is ready for release! 
(Snacks:Roasted Turkey) is ready for release! 

(Snacks:Lime) is ready for release! 

(Snacks:Hazelnut) is ready for release! 

(Snacks:Radishes, Daikon) tasted bad! Reworking... 
(Snacks:Radishes, Daikon) tasted bad! Reworking... 
(Snacks:Radishes, Daikon) failed the readthrough! Reworking... 
(Snacks:Radishes, Daikon) tasted bad! Reworking... 
(Snacks:Radishes, Daikon) is ready for release! 
(Snacks:Salami) failed the readthrough! Reworking... 
(Snacks:Salami) is ready for release! 


1 
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.10 (Snacks:Mushroom, Oyster) failed the readthrough! Reworking... 


6.10 (Snacks:Mushroom, Oyster) is ready for release! 
Finished Evaluating Chapter 6 - Snacks 
Evaluating Chapter 7 - Breakfast 
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(Breakfast:Daikon Radish) had incorrect measurements! Reworking... 


(Breakfast:Daikon Radish) is ready for release! 
(Breakfast:Lettuce, Red Leaf) failed final editing! Reworking... 
(Breakfast:Lettuce, Red Leaf) is ready for release! 
(Breakfast:Alfalfa Sprouts) is ready for release! 
(Breakfast:Tea Cakes) is ready for release! 
(Breakfast:Chia seed) is ready for release! 
(Breakfast:Tangerine) is ready for release! 
(Breakfast:Spinach) is ready for release! 
(Breakfast:Flank Steak) is ready for release! 
(Breakfast:Loganberries) had incorrect measurements! Reworking... 
(Breakfast:Loganberries) had incorrect measurements! Reworking... 
(Breakfast:Loganberries) had incorrect measurements! Reworking... 
(Breakfast:Loganberries) is ready for release! 


.10 (Breakfast:Opossum) is ready for release! 


Finished Evaluating Chapter 7 - Breakfast 
Evaluating Chapter 8 - Sandwiches 

8.1 (Sandwiches:Rhubarb) tasted bad! Reworking... 
8.1 (Sandwiches:Rhubarb) is ready for release! 

8.2 (Sandwiches:Pickle, Brine) is ready for release! 
8.3 (Sandwiches:Oranges) tasted bad! Reworking... 
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(Sandwiches:Oranges) had incorrect measurements! Reworking... 
(Sandwiches:Oranges) is ready for release! 


(Sandwiches:Chayote, Pipinella, Vegetable Pear) tasted bad! Reworking... 


(Sandwiches:Chayote, Pipinella, Vegetable Pear) is ready for release! 
(Sandwiches:Bear) is ready for release! 

(Sandwiches:Panela) had incorrect measurements! Reworking... 
(Sandwiches:Panela) is ready for release! 

(Sandwiches:Peppers, Red) had incorrect measurements! Reworking... 
(Sandwiches:Peppers, Red) tasted bad! Reworking... 
(Sandwiches:Peppers, Red) failed the readthrough! Reworking... 
(Sandwiches:Peppers, Red) failed the readthrough! Reworking... 
(Sandwiches:Peppers, Red) had incorrect measurements! Reworking... 
(Sandwiches:Peppers, Red) tasted bad! Reworking... 
(Sandwiches:Peppers, Red) is ready for release! 

(Sandwiches:Oat Bread) is ready for release! 

(Sandwiches:Peppers, Green) is ready for release! 


.10 (Sandwiches:Garlic) is ready for release! 


Finished Evaluating Chapter 8 - Sandwiches 
kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 


Full Chapter Evaluation with LINQ took: 00:01:19.1395258 


kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 














PLINQ 的 输出 示例 如 下 所 示 ， 它 是 并 行 处 理 的 (注意 开头 处 对 4 个 RecipeChapter 进行 了 
评估 ) ， 以 打 乱 的 顺序 处 理 数 据 项 。 
































Evaluating Chapter 5 - Desserts 
Evaluating Chapter 3 - Appetizers 
Evaluating Chapter 1 - Soups 


Evaluating Chapter 7 - Breakfast 
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(Breakfast:Daikon Radish) failed the readthrough! Reworking... 
(Soups:Sprouts, Mung Bean) failed the readthrough! Reworking... 
(Appetizers:Loquat) had incorrect measurements! Reworking... 
(Soups:Sprouts, Mung Bean) had incorrect measurements! Reworking... 
(Breakfast:Daikon Radish) tasted bad! Reworking... 
(Desserts:Mushroom, White, Silver Dollar) tasted bad! Reworking... 
(Appetizers:Loquat) failed final editing!  Reworking... 
(Breakfast:Daikon Radish) is ready for release! 

(Appetizers:Loquat) tasted bad! Reworking... 

(Desserts:Mushroom, White, Silver Dollar) tasted bad! Reworking... 
(Soups:Sprouts, Mung Bean) is ready for release! 
(Appetizers:Loquat) is ready for release! 

(Soups:Potato Bread) had incorrect measurements! Reworking... 
(Soups:Potato Bread) is ready for release! 

(Soups:Chicken Liver) failed the readthrough! Reworking... 
(Appetizers:Bergenost) is ready for release! 

(Soups:Chicken Liver) had incorrect measurements! Reworking... 
(Breakfast:Lettuce, Red Leaf) failed final editing! Reworking... 
(Desserts:Mushroom, White, Silver Dollar) is ready for release! 
(Desserts:Eggplant) is ready for release! 

(Breakfast:Lettuce, Red Leaf) tasted bad! Reworking... 
(Appetizers:Tomato Red Roma) is ready for release! 

(Soups:Chicken Liver) is ready for release! 

(Appetizers:Guava) is ready for release! 

(Desserts:Asparagus Peas) is ready for release! 

(Soups:Cherimoya) is ready for release! 
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(Desserts:Squash, Kabocha) is ready for release! 
(Soups:High-Protein Bread) had incorrect measurements! Reworking... 
(Breakfast:Lettuce, Red Leaf) failed final editing! Reworking... 
(Soups:High-Protein Bread) failed final editing!  Reworking... 
(Desserts:Sprouts, Radish) is ready for release! 
(Appetizers:Squash Flower) is ready for release! 
(Appetizers:Radishes, Red) failed the readthrough! Reworking... 
(Soups:High-Protein Bread) is ready for release! 
(Desserts:Mushroom, Black Trumpet) tasted bad! Reworking... 
(Soups:Flat Bread) is ready for release! 

(Soups:Pomegranate) is ready for release! 

(Appetizers:Radishes, Red) is ready for release! 
(Breakfast:Lettuce, Red Leaf) is ready for release! 
(Desserts:Mushroom, Black Trumpet) failed final editing!  Reworking... 
(Soups:Carissa, Natal Plum) is ready for release! 
(Breakfast:Alfalfa Sprouts) is ready for release! 

(Breakfast:Tea Cakes) is ready for release! 

(Desserts:Mushroom, Black Trumpet) is ready for release! 
(Appetizers:Goose Liver) is ready for release! 

(Soups:Ideal Flat Bread) is ready for release! 

(Desserts:Tea Cakes) tasted bad! Reworking... 

(Appetizers:Okra) is ready for release! 

(Appetizers:Borage) tasted bad! Reworking... 

(Appetizers:Borage) failed the readthrough! Reworking... 
(Appetizers:Borage) failed the readthrough! Reworking... 
(Breakfast:Chia seed) is ready for release! 

(Appetizers:Borage) is ready for release! 


.10 (Soups:Banana Bread) is ready for release! 


Finished Evaluating Chapter 1 - Soups 
Evaluating Chapter 2 - Salads 

3.10 (Appetizers:Peppers) is ready for release! 
Finished Evaluating Chapter 3 - Appetizers 
Evaluating Chapter 4 - Entrees 
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(Desserts:Tea Cakes) is ready for release! 

(Breakfast: Tangerine) is ready for release! 
(Entrees:Plantain) is ready for release! 

(Entrees:Pignola (Pine)) failed the readthrough! Reworking... 
(Salads:Caraway) is ready for release! 
(Desserts:Blueberries) is ready for release! 
(Desserts:Sago Palm) failed the readthrough! Reworking... 
(Desserts:Sago Palm) tasted bad! Reworking... 
(Desserts:Sago Palm) is ready for release! 
(Entrees:Pignola (Pine)) is ready for release! 
(Salads:Potatoes, Red) is ready for release! 
(Salads:Lemon) had incorrect measurements! Reworking... 
(Entrees:Potatoes, Gold) is ready for release! 
(Breakfast:Spinach) failed final editing!  Reworking... 
(Salads:Lemon) had incorrect measurements! Reworking... 
(Entrees:Ribeye) had incorrect measurements! Reworking... 
(Breakfast:Spinach) tasted bad! Reworking... 
(Entrees:Ribeye) is ready for release! 

(Salads:Lemon) tasted bad! Reworking... 


.10 (Desserts:Opossum) is ready for release! 


Finished Evaluating Chapter 5 - Desserts 
Evaluating Chapter 6 - Snacks 
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(Snacks:Cheddar) is ready for release! 

(Entrees:Sprouts, Mung Bean) is ready for release! 
(Breakfast:Spinach) is ready for release! 

(Snacks:Melon, Bitter) is ready for release! 
(Snacks:Scallion) failed the readthrough! Reworking... 
(Breakfast:Flank Steak) tasted bad! Reworking... 
(Salads:Lemon) failed final editing!  Reworking... 
(Breakfast:Flank Steak) is ready for release! 
(Entrees:Squash) is ready for release! 

(Salads:Lemon) tasted bad! Reworking... 

(Entrees:Squash, Winter) failed the readthrough! Reworking... 
(Entrees:Squash, Winter) had incorrect measurements! Reworking... 
(Snacks:Scallion) is ready for release! 

(Snacks:Squash Chayote) is ready for release! 
(Entrees:Squash, Winter) is ready for release! 
(Breakfast:Loganberries) is ready for release! 

(Salads:Lemon) is ready for release! 
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.10 (Breakfast:Opossum) is ready for release! 


Finished Evaluating Chapter 7 - Breakfast 
Evaluating Chapter 8 - Sandwiches 
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.1 (Sandwiches:Rhubarb) had incorrect measurements! Reworking... 


(Entrees:Corn, Blue) is ready for release! 

(Salads:Cream cheese) failed final editing! Reworking... 
(Salads:Cream cheese) is ready for release! 

(Snacks:Roasted Turkey) failed final editing! Reworking... 
(Entrees:Snake) is ready for release! 


ont BRO 


.10 (Entrees:Prosciutto) failed the readthrough! Reworking... 

.5 (Snacks:Roasted Turkey) had incorrect measurements! Reworking... 
.5 (Salads:Artichokes, Domestic) tasted bad! Reworking... 

.10 (Entrees:Prosciutto) tasted bad! Reworking... 

.1 (Sandwiches:Rhubarb) tasted bad! Reworking... 

.10 (Entrees:Prosciutto) had incorrect measurements! Reworking... 
.10 (Entrees:Prosciutto) is ready for release! 


Finished Evaluating Chapter 4 - Entrees 
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.5 (Snacks:Roasted Turkey) is ready for release! 


(Snacks:Lime) had incorrect measurements! Reworking... 
(Salads:Artichokes, Domestic) failed final editing! Reworking... 
(Sandwiches:Rhubarb) is ready for release! 

(Snacks:Lime) tasted bad! Reworking... 

(Snacks:Lime) is ready for release! 

(Salads:Artichokes, Domestic) is ready for release! 
(Snacks:Hazelnut) is ready for release! 

(Sandwiches:Pickle, Brine) is ready for release! 
(Salads:Grapefruit) is ready for release! 


(Salads:Lettuce, Iceberg) is ready for release! 
(Snacks:Radishes, Daikon) is ready for release! 
(Sandwiches:Oranges) is ready for release! 
(Snacks:Salami) tasted bad! Reworking... 
(Salads:Fenugreek) is ready for release! 


(Sandwiches:Chayote, Pipinella, Vegetable Pear) tasted bad! Reworking... 


(Salads:Ostrich) failed the readthrough! Reworking... 
(Snacks:Salami) is ready for release! 
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.10 (Snacks:Mushroom, Oyster) is ready for release! 


Finished Evaluating Chapter 6 - Snacks 
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(Salads:Ostrich) failed final editing! Reworking... 
(Salads:Ostrich) failed the readthrough! Reworking... 
(Salads:Ostrich) failed the readthrough! Reworking... 
(Sandwiches:Chayote, Pipinella, Vegetable Pear) is ready for release! 
(Sandwiches:Bear) is ready for release! 

(Salads:Ostrich) failed final editing! Reworking... 
(Sandwiches:Panela) tasted bad! Reworking... 
(Sandwiches:Panela) failed the readthrough! Reworking... 
(Salads:Ostrich) is ready for release! 
(Sandwiches:Panela) had incorrect measurements! Reworking... 
(Sandwiches:Panela) is ready for release! 

.10 (Salads:Brazil Nuts) is ready for release! 

inished Evaluating Chapter 2 - Salads 

.7 (Sandwiches:Peppers, Red) tasted bad! Reworking... 

.7 (Sandwiches:Peppers, Red) tasted bad! Reworking... 

.7 (Sandwiches:Peppers, Red) is ready for release! 

.8 (Sandwiches:Oat Bread) is ready for release! 

.9 (Sandwiches:Peppers, Green) is ready for release! 

8.10 (Sandwiches:Garlic) is ready for release! 

Finished Evaluating Chapter 8 - Sandwiches 
kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 


Full Chapter Evaluation with PLINQ took: 00:00:25.1708103 
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Cookbook Evaluation Complete 
如 果 你 运行 了 一 个 PLINQ 查询 ， 并 且 调 用 到 的 操作 引发 了 一 个 异常 ， 此 时 它 将 不 会 
停止 运算 ， 而 是 继续 运行 ， 并 将 所 有 异常 记录 到 一 个 AggregateException 中 。 这 个 
AggregateException 可 以 在 查询 运算 求 值 后 捕获 到 (而 非 查询 声明 后 )。 























4.14.4 ”参考 
MSDN 文档 中 的 “并 行 LINQ” 主 题 。 





第 5 章 


调试 和 异常 处 理 





5.0 简介 


本 章 包 含 的 范例 涉及 异常 处 理 机 制 ， 包 括 try, catch 和 finally 语句 块 。 除 了 这 些 范例 之 
外 ， 还 有 一 些 范例 介绍 了 用 于 从 代码 内 手动 引发 异常 的 机 制 。 最 后 的 范例 涉及 Exception 
类 及 其 使 用 ， 以 及 对 其 进行 子 类 化 以 创建 新 的 异常 类 型 。 


通常 ， 异 常 处 理 的 设计 和 实现 是 在 开发 周期 后 期 执行 的 。 但 是 ， 由 于 Ch 异常 处 理 的 能 
和 复杂 性 ， 需 要 更 早 地 计划 乃至 实现 异常 处 理 模 式 。 这 样 做 可 以 提高 代码 的 可 靠 性 和 健壮 
性 ， 同 时 可 以 将 在 绝 大 部 分 或 全 部 应 用 程序 编码 完成 之 后 添加 异常 处 理 的 影响 减 至 最 小 。 


CH 中 的 异常 处 理 非常 灵活 。 它 允许 选择 一 种 细 粒 度 或 粗 粒 度 的 方法 进行 错误 处 理 ， 任 意 
中 间 的 处 理 粒度 也 均 可 。 这 意味 着 可 以 在 任何 一 行 代码 周围 ( 细 粒 度 方法 ) 或 者 在 一 个 调 
用 其 他 许多 方法 的 方法 周围 ( 粗 粒 度 方法 ) 添加 异常 处 理 ， 也 可 以 混合 使 用 这 两 种 方法 : 
主要 使 用 粗 粒 度 方法 ， 并 且 在 特定 的 关键 代码 区 域 使 用 更 细 粒 度 的 方法 。 在 使 用 细 粒 度 方 
法 时 ， 可 以 截获 可 能 只 由 几 行 代码 引发 的 特定 异常 。 下 面 的 方法 使 用 细 粒 度 的 异常 处 理 把 
对 象 的 属性 设置 为 一 个 数值 。 

protected void SetValue(object value) 


( 







































































try 
{ 
myObj.Property1 = value; 


catch (NullReferenceException) 


// 在 此 处 处 理 这 一 调用 可 能 引发 的 异常 
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因此 ， 如 果 在 整个 应 用 程序 中 使 用 这 种 方法 ， 可 能 会 增加 大 量 多 余 的 代码 。 如 果 只 有 一 行 
或 几 行 代码 ， 并 且 需 要 以 一 种 特定 的 方式 处 理 异常 ， 就 应 该 使 用 这 种 细 粒 度 的 异常 处 理 方 
法 。 如 果 无 需 在 这 种 级 别 进 行 特定 的 错误 处 理 ， 就 应 该 把 异常 冒 泡 到 栈 上 。 例 如 ， 使 用 前 
AMY SetValue 方法 ， 你 可 能 必须 通知 用 户 发 生 的 异常 ， 并 提供 重 试 的 机 会 。 如 果 无 论 何 时 
my0bj 的 方法 之 一 引发 异常 都 需要 调用 my0bj 上 的 一 个 方法 ， 就 应 该 确保 在 合适 的 时 间 调 
用 该 方法 。 


粗 粒 度 的 异常 处 理 完全 相反 ， 它 使 用 更 少 的 try-catch ak try-catch-finally 块 。 一 个 例子 
是 在 应 用 程序 或 组 件 的 每 个 public 方法 中 的 所 有 代码 周围 放置 一 个 try-catch 块 。 这 样 做 
允许 在 代码 中 的 最 高 级 别 上 处 理 异常 。 如 果 在 代码 中 的 任意 位 置 引 发 异常 ， 都 将 把 它 冒 泡 
到 调用 栈 上 ， 直 至 找到 可 以 处 理 它 的 catch 块 为 止 。 如 果 在 所 有 公共 方法 上 放置 try-catch 
块 ， 则 会 将 所 有 异常 冒 泡 给 这 个 方法 并 处 理 它们 。 这 样 可 以 少 写 很 多 异常 处 理 代码 ， 但 是 
会 降低 处 理 那 些 可 能 发 生 在 代码 中 特定 区 域 的 特定 异常 的 能 力 。 你 必须 确定 向 应 用 程序 中 
添加 异常 处 理 代 码 的 最 佳 方式 。 这 意味 着 在 应 用 程序 中 的 细 粒 度 异 常 处 理 与 粗 粒度 异常 处 
星之 间 达 到 一 种 适当 的 平衡 。 

CH 允许 不 带 任何 参数 地 编写 catch 块 。 这 样 的 一 个 示例 如 下 所 示 。 


public void CallCOMMethod() 
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{ 
try 
// Call a method on a COM object. 
myCOMObj.Method1(); 
} 
catch 
// 在 此 处 处 理 这 一 调用 可 能 引发 的 异常 
} 


不 带 参数 的 catch 继承 自 C++, TE C++ 中 ， 异 常 对 象 不 必 从 Exception 类 派生 而 来 。 在 
C++ 中 以 这 种 方式 编写 catch 子 句 人 允许 捕获 作为 异常 引发 的 任何 类 型 的 对 象 。 不 过 ， 在 
Ci 中 ， 只 有 从 Exception 基 类 派生 而 来 的 任何 对 象 才 可 能 作为 异常 引发 。 使 用 不 带 参数 的 
catch 块 允 许 捕获 所 有 异常 ， 但 是 将 不 能 查看 异常 及 其 信息 。 以 这 种 方式 编写 的 catch Ee 
如 下 所 示 。 


catch 





























// 不 能 编写 下 一 行 所 示 的 代码 
//Console.WriteLine(e.ToString); 


} 
已 与 下 面 这 个 catch 块 相同 : 


catch (Exception e) 














// 能 够 编写 下 一 行 所 示 的 代码 


Console.WriteLine(e.ToString); 








只 不 过 在 第 二 种 情况 下 提供 了 异常 参数 ， 因 此 可 以 访问 Exception 对 象 。 

不 要 编写 不 带 任何 参数 的 catch 块 ， 这 样 做 将 阻止 你 访问 引发 的 实际 Exception 对 象 。 

在 catch 块 中 捕获 异常 时 ， 应 该 事先 确定 何 时 需要 重新 引发 异常 ， 何 时 需要 把 异常 包装 在 
一 个 外 部 异常 中 并 引发 它 ， 以 及 何 时 应 该 立即 处 理 异常 并 且 不 重新 引发 它 。 

当 原始 异常 对 调用 者 没有 意义 时 ， 把 异常 包装 在 一 个 外 部 异常 中 是 一 个 良好 的 惯例 。 当 把 
异常 包装 在 一 个 外 部 异常 中 时 ， 需 要 确定 什么 异常 最 适合 包装 捕获 的 异常 。 一 条 经 验 法 则 
是 ， 包 装 异常 应 该 总 是 便于 跟踪 原始 问题 ， 而 不 要 用 无 关 的 或 模糊 的 包装 异常 来 屏蔽 原始 
异常 。 在 极 少 情况 下 ， 会 认为 屏蔽 异常 是 合理 的 ， 其 中 有 一 种 情况 是 ， 如 果 异 常 将 要 跨越 
信任 界限 ， 出 于 安全 原因 就 必须 屏蔽 它 。 

上 获 异 常 时 另 一 个 很 有 用 的 实践 是 ， 在 代码 中 提供 处 理 特定 异常 的 catch 块 。 记 住 基 类 异 
Tí (在 catch 块 中 使 用 时 ) 不 仅 会 捕获 该 类 型 ， 还 会 捕获 其 所 有 子 类 。 

下 面 的 代码 使 用 特定 的 catch 语句 块 以 合适 的 方式 处 理 不 同 的 异常 。 


public void CallCOMMethod() 
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{ 
try 
// 调用 COM 对 象 上 的 一 个 方法 
myCOMObj . Method1(); 
} 
catch (System.Runtime.InteropServices.ExternalException) 
// 在 此 处 处 理 这 一 调用 可 能 引发 的 COM 异 常 
catch (InvalidOperationException) 
// 处 理 当 前 状态 下 针对 COM 对 象 的 任何 可 能 无 效 的 方法 调用 
} 


在 这 段 代码 中 ，ExternalException 及 其 所 派生 异常 的 处 理 方式 不 同 于 InvalidOpera- 
tionException 及 其 派生 的 异常 。 如 果 从 myCOMObj.Method1 引发 任何 其 他 类 型 的 异常 ， 将 
不 会 在 这 里 处 理 它 们 ， 但 是 会 冒 泡 直 至 找到 有 效 的 catch 块 。 如 果 没 有 找到 有 效 的 catch 
块 ， 就 会 认为 该 异常 未 被 处 理 ， 并 且 终 止 应 用 程序 。 

有 时 ， 不 管 是 否 引 发 异常 ， 都 必须 执行 清理 代码 。 当 引发 异常 时 ， 任 何 对 象 都 必须 置 于 一 
种 稳定 的 已 知 状态 中 。 在 这 些 情况 下 ， 如 果 必 须 执 行 代码 ， 就 使 用 finally HE JER, TT 
的 代码 被 修改 成 了 使 用 finally 语句 块 。 


public void CallCOMMethod() 
{ 










































































try 

{ 
// 调用 COM 对 象 上 的 一 个 方法 
myCOMObj . Method1(); 


catch (System.Runtime.InteropServices.ExternalException) 
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// 在 此 处 处 理 这 一 调用 可 能 引发 的 COM 异 常 
finally 


{ 
// 在 此 处 清理 并 释放 任何 资源 
// 例如 ,在 mycoMobj 上 可 能 有 一 个 方法 允许 我 们 
// 在 使 用 Method1 方 法 后 进行 清理 





AVE try 和 catch 语句 块 中 发 生 什 么 事情 ， 总 会 执行 finally 语句 块 。 即 使 
在 try 或 catch 块 中 执行 return, break 或 continue 语句 或 者 使 用 goto Hk 
出 异常 处 理 程序 ， 也 会 执行 finally 语句 块 。 这 就 在 执行 try (可 能 还 有 
catch) 语句 块 代码 之 后 提供 了 一 个 可 靠 的 清理 方法 。 








如 果 没 有 指定 catch 语句 块 ， 那 么 finally 语句 块 对 于 最 终 的 资源 清理 也 是 非常 有 用 的 。 
如 果 将 要 编写 的 代码 不 能 处 理 来 自 它 所 执行 调用 的 异常 ， 但 又 希望 确保 它 使 用 的 资源 在 栈 
中 辣 上 移动 之 前 被 正确 地 清理 ， 就 可 以 使 用 这 种 模式 。 下 面 的 示例 通过 使 用 using 关键 字 
确保 在 Finally 语句 块 中 正确 地 清理 了 SqlConnection 和 SqlCommand, using 关键 字 用 一 个 
try-finally 语句 块 包装 了 using 语句 的 作用 域 。 


public static int GetAuthorCount(string connectionString) 


{ 














SqlConnection sqlConn = null; 
SqlCommand sqlComm = null; 


using(sqlConn = new SqlConnection(connectionString)) 
using (sqlComm - new SqlCommand()) 


sqlComm.Connection = sqlConn; 

sqlComm.Parameters.Add("@pubName" , 
SqlDbType.NChar).Value = "O''Reilly"; 

sqlComm.CommandText = "SELECT COUNT(*) FROM Authors " + 
"WHERE Publisher=@pubName" ; 


sqlConn.Open(); 
object authorCount - sqlComm.ExecuteScalar(); 
return (int)authorCount; 


} 
} 


在 确定 如 何在 应 用 程序 或 组 件 中 组 织 异 常 处 理 之 前 ， 考 虑 执行 以 下 操作 。 

。 在 代码 中 较 高 层级 的 位 置 使 用 单个 try-catch 或 try-catch-finatty 异常 处 理 程序 。 可 
以 将 这 种 异常 处 理 程序 视 为 粗 粒 度 的 。 

。 调用 栈 中 较 低层 级 的 代码 应 该 包含 try-finatty 异常 处 理 程序 。 可 以 将 这 种 异常 处 理 程 
序 视 为 细 粒 度 的 。 
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在 异常 发 生 后 ， 细 粒度 的 try-finally 异常 处 理 程序 允许 更 好 地 控制 清理 工作 。 然 后 把 异 


常 冒 泡 到 粗 粒度 的 try-catch 或 try-catch-finally 异常 处 理 程序 。 这 种 技术 允许 一 种 更 集 





中 的 异常 处 理 模式 ， 并 且 把 必须 编写 用 于 处 理 异 常 的 代码 减 至 最 少 。 





如 果 你 知道 代码 将 在 单线 程 环境 中 运行， 为 了 改进 性 能 ， 应 该 处 理 可 能 引发 异常 的 情 
况 ， 而 不 是 在 引发 异常 后 捕获 它 。 如 果 代 码 将 在 多 线程 上 运行 ， 那 么 初始 检查 仍 有 可 能 
功 ， 但 是 在 能 够 采取 的 检查 之 后 ， 对 象 值 可 能 在 操作 之 前 在 另 一 个 线程 中 改变 (也 许 变 为 




















null), 





例如 ， 在 单线 程 环境 中 ， 如 果 一 个 方法 有 很 大 可 能 返回 一 个 null 值 ， 那 么 在 使 用 
返回 的 值 之 前 应 该 测试 该 值 是 否 为 null, m s try-catch 语句 块 并 允许 引发 
NullReferenceException。 如 果 你 认为 null 值 是 可 能 的 ， 就 要 检查 它 。 如 果 不 应 该 发 生 这 
种 情况 ， 那 么 当 它 发 生 时 就 是 一 种 异常 条 件 ， 并 有 目 应 读 使 用 异常 处 理 。 为 了 说 明 这 一 点 ， 









































下 面 给 出 了 一 个 方法 ， 它 使 用 异常 处 理 代 码 来 处 理 NullReferenceException。 


public void SomeMethod() 


{ 
try 


{ 


7 














Stream s = GetAnyAvailableStream(); 
Console.WriteLine("This stream has a length of " + s.Length); 


catch (NullReferenceException) 


|] 此 处 处 理 空 的 流 





} 
下 面 的 方法 代 之 以 使 用 if-else 条 件 语句 来 实现 。 


public void SomeMethod() 





7 

















{ 
Stream s = GetAnyAvailableStream(); 
if (s != null) 
Console.WriteLine("This stream has a length of " + s.Length); 
} 
else 
// 此 处 处 理 空 的 流 
} 


此 外 ， 你 还 应 该 确保 以 如 下 方式 使 用 finally 语句 块 关闭 此 流 。 


public void SomeMethod() 
{ 


Stream s = null; 
using(s = GetAnyAvailableStream()) 


if (s != null) 
{ 


Console.WriteLine("This stream has a length of " + s.Length); 
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} 


else 


N 


// 此 处 处 理 空 的 流 





} 
} 


finally 语句 块 包含 将 关闭 流 的 方法 调用 ， 从 而 确保 不 会 有 数据 丢失 。 


考虑 引发 异常 ， 而 不 是 返回 错误 代码 。 利 用 良好 放置 的 异常 处 理 代 码 ， 应 该 不 必 依 靠 返 回 
错误 代码 (例如 布尔 值 true-false) 的 方法 正确 地 处 理 错 误 ， 这 可 以 使 得 代码 更 清晰 。 另 
一 个 好 处 是 不 必 为 错误 代码 查找 任何 值 以 理解 该 代码 。 






































异常 的 最 大 优点 是 ， 当 异常 情况 发 生 时 ， 不 能 像 对 待 错误 代码 那样 仅仅 忽略 
它 。 这 有 助 于 查找 和 修正 错误 。 


要 尽量 引发 特定 的 异常 ， 而 不 是 一 般 的 异常 。 例 如 ， 引 发 一 个 ArgumentNullException 而 
不 是 一 个 ArgumentException， 后 者 是 前 者 的 基 类 。 引 发 一 个 ArgumentException 只 是 告诉 
你 方法 的 参数 值 有 问题 ;引发 一 个 ArgumentNuLLException 则 更 确切 地 告诉 你 参数 的 真正 
问题 是 什么 。 男 一 个 潜在 的 问题 是 ， 如 果 异 常 捕获 程序 正在 寻找 从 引发 的 异常 派生 而 来 的 
更 具体 的 类 型 ， 就 可 能 不 会 捕获 更 一 般 的 异常 。 


FCL 提供 了 几 种 异常 类 型 ， 你 将 会 发 现在 自己 的 代码 中 引发 它们 是 非常 有 用 的 。 下 面 列 出 
了 其 中 许多 异常 ， 并 且 定义 了 应 该 在 何 时 、 何 处 引发 它们 。 


。 使 用 一 个 非 适当 状态 的 对 象 调用 一 个 属性 、 索 引 器 或 方法 时 ， 引 发 一 个 
InvalLidoperationException。( 例 如 ， 对 尚未 初始 化 的 对 象 调 用 一 个 索引 器 或 者 未 按 顺 
序 地 调用 方法 时 。) 

© 如 果 传 入 方法 、 属 性 或 索引 器 中 的 参数 无 效 ， 就 引发 ArgumentException。 
ArgumentNullException, ArgumentOutOfRangeException 和 InvalidEnumArgumentException 
是 ArgunentException 的 三 个 子 类 ， 引 发 其 中 一 个 子 类 化 的 异常 是 更 合适 的 ， 因 为 它们 
更 清楚 地 指示 了 问题 的 根源 。ArgumentNuLLException 指示 传 入 的 参数 是 null， 而 这 个 
参数 在 任何 情况 下 都 不 能 为 null, ArgimentOutOfRangeException 指示 传人 的 参数 在 可 
接受 的 有 效 范 围 之 外 。 这 个 异常 主要 用 于 数值 。InvalidEnumArgumentException 指示 传 
入 的 枚 举 值 不 在 该 枚 举 类 型 中 。 

。 当 把 一 个 无 效 的 格式 化 参数 作为 参数 传人 一 个 方法 中 时 ， 就 引发 一 个 FormatException, 
这 种 技术 主要 用 于 重 写 / 重 载 类 似 ToString() 的 接受 格式 化 字符 串 的 方法 时 ， 以 及 用 在 
各 种 数字 类 型 上 的 解析 方法 中 。 

© 当 对 一 个 已 被 处 置 的 对 象 调用 属性 、 索 引 或 方法 时 ， 就 引发 一 个 ObjectDisposed- 
Exception, 

e 从 SystemException 类 派生 而 来 的 许多 异常 ， 例 如 NullReferenceException, Execution- 
EngineException, StackOverflowException, OutOfMemoryException 和 Index- 
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OutOfRangeException, AREF CLR 引发 ， 而 不 应 该 在 代码 中 利用 throw 关键 字 显 式 引 

发 它们 。 
.NET Framework 类 库 (FCL) 中 包含 许多 类 ， 用 于 获得 关于 应 用 程序 的 诊断 信息 ， 以 
及 它 运行 所 在 的 环境 。 事实 上 ， 这 样 的 类 有 很 多 ， 并 且 创 建 了 一 个 命名 空间 System. 
Diagnostics 来 包含 所 有 这 些 类 。 本 章 包含 一 些 范 例 ， 利 用 调试 / 跟踪 信息 检测 应 用 程 
序 、 获 得 进程 信息 、 使 用 内 置 的 事件 日 志 ， 以 及 利用 如 性 能 计数 器 或 者 Windows 事件 跟 
踪 (ETW) 和 EventSource 等 机 制 。 应 该 指出 的 是 ，ETW 和 EventSource 正成 为 .NET 
Framework 中 首选 的 性 能 遥测 机 制 。 


默认 情况 下 ， 只 在 调试 构建 时 才 打 开 调试 支持 〈 使 用 Debug 类 )， 而 跟踪 (使 用 Trace 类 ) 
则 在 调试 和 发 布 构建 时 都 会 打开 。 这 些 默认 情况 允许 交付 使 用 Trace 类 的 跟踪 代码 来 检测 
的 应 用 程序 。 交 付 编译 有 跟踪 支持 的 代码 ， 但 在 配置 中 关闭 它 ， 因 此 跟踪 代码 不 会 被 调用 
出 于 性 能 原因 )， 除 非 它 是 服务 器 端 应 用 程序 〈 此 类 应 用 中 ， 检 测 信息 的 价值 要 超出 性 能 
损失 ， 并 且 在 云 中 只 能 通过 日 志 来 了 解 程序 行为 )。 如 果 在 生产 机 器 上 发 生 在 开发 机 器 上 
不 能 重建 的 问题 ， 就 可 以 启用 跟踪 并 允许 把 跟踪 信息 转 储 到 一 个 文件 中 。 然 后 可 以 检查 该 
文件 ， 以 帮助 查 明 真正 的 问题 。 


由 于 Debug 类 和 Trace 类 都 包含 具有 相同 名 称 的 相同 成 员 ， 所 以 可 以 在 代码 中 通过 把 Debug 
重 命 名 为 Trace (反之 亦 然 ) 来 互 换 它们 。 本 章 中 的 大 多 数 范例 都 使 用 Trace 类 ， 要 修改 
这 些 范 例 以 使 用 Dubug 类 代替 ， 只 需 在 代码 中 用 Debug 替换 每 个 Trace 实例 即 可 。 


5.1 知道 何 时 捕获 并 重新 引发 异常 


5.1.1 问题 
你 想 确定 何 时 捕获 并 重新 引发 一 个 异常 是 合适 的 。 


5.1.2 解决 方案 


如 有 果 你 有 一 个 代码 区 域 ， 当 某 个 异常 发 生 时 你 想 在 其 中 执行 某 种 操作 ， 但 是 不 想 采 取 任 何 
操作 实际 地 处 理 异 常 ， 那 么 捕获 并 重新 引发 该 异常 就 是 合适 的 。 为 了 获取 异常 以 便 对 它 执 
行 初始 操作 ， 可 以 建立 一 个 catch 语句 块 来 捕获 异常 。 然 后 ， 一 旦 执行 了 该 操作 ， 就 从 处 
理 原始 异常 的 catch 语句 块 中 重新 引发 异常 。 使 用 throw 关键 字 后 接 一 个 分 号 来 重新 引发 
一 个 异常 ， 代 码 如 下 所 示 。 


try 

{ 
Console.WriteLine("In try"); 
int z2 = 9999999; 
checked { z2 *= 999999999; } 


























— 





























catch (OverflowException oe) 





// 记录 溢出 异常 发 生 的 事实 
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EventLog.WriteEntry("MyApplication", oe.Message, EventLogEntryType.Error); 
throw; 


} 
此 外 创建 了 一 个 EventLog KA, AFicRe RAM RH. SAI, iid throw 语句 将 该 异 
常 冒 泡 到 调用 栈 。 
5.1.3 讨论 
为 异常 建立 一 个 catch 语句 块 实质 上 是 表达 想 对 该 异常 情况 执行 某 种 操作 。 
如 果 你 没有 重新 引发 异常 ， 或 者 创建 一 个 新 异常 来 包装 原始 的 异常 并 引发 


它 ， 那 么 就 可 以 认为 你 已 经 处 理 了 异常 引发 的 情况 ， 并 且 程 序 可 以 继续 执行 
正常 的 操作 。 


























F 
































通过 选择 重新 引发 异常 ， 说 明 仍 然 有 一 个 问题 需要 处 理 ， 并 且 依 靠 栈 上 面 距离 较 远 的 代码 
来 处 理 这 种 条 件 。 如 果 你 需要 基于 引发 的 异常 执行 某 种 操作 并 且 需 要 在 代码 执行 后 允许 异 
常 继 续 存 在 ， 那 么 就 可 以 用 重新 引发 异常 的 机 制 来 处 理 这 种 情况 。 如 果 这 两 个 条 件 都 不 满 
足 ， 就 不 要 重新 引发 异常 ， 只 需 处 理 它 或 者 删除 catch 语句 块 。 












































要 记得 引发 异常 的 代价 很 高 。 不 要 尝试 不 必要 地 引发 和 重新 引发 异常 ， 因 为 
这 可 能 使 应 用 程序 陷入 困境 。 








在 重新 引发 异常 时 ， 使 用 throw; ， 而 不 要 使 用 throw ex;， 因 为 throw; 将 保留 异常 的 原始 
调用 栈 。 使 用 带 有 catch 参数 的 throw 将 把 调用 栈 重 设 到 那个 位 置 ， 并 且 关 于 错误 的 信息 
也 将 会 丢失 。 可 能 在 某 些 情况 下 你 想 要 更 改 调用 堆栈 (例如 要 隐藏 应 用 程序 执行 敏感 操作 
部 分 的 内 部 细节 )， 但 整体 来 说 ， 给 自己 最 好 的 机 会 去 调试 而 不 要 截断 调用 堆栈 。 


5.2 处理 通过 反射 调用 的 方法 引发 的 异常 


5.2.1 问题 
使 用 反射 可 以 调用 一 个 会 生成 异常 的 方法 。 你 希望 获得 真正 的 异常 对 象 及 其 信息 ， 以 便 诊 
断 和 修正 问题 。 


5.2.2 ”解决 方案 


可 以 通过 MethodInfo.Invoke 引发 的 TargetInvocationException 的 InnerException 属性 获 
得 真正 的 异常 及 其 信息 。 














5.2 
例 5- 


3 讨论 


1 处 理 了 在 通过 反射 调用 的 方法 内 发 生 的 一 个 异常 。Reflect 类 包含 一 个 





ReflectionException 方法 ， 它 使 用 反射 类 调用 静态 方法 TestInvoke, 


例 5 


-1: 获得 通过 反射 调用 的 方法 所 引发 异常 的 信息 


using System; 
using System.Reflection; 


public static class Reflect 


{ 
public static void ReflectionException( ) 
{ 
Type reflectedClass = typeof (DebuggingAndExceptionHandling) ; 
try 
{ 
MethodInfo methodToInvoke = reflectedClass.GetMethod("TestInvoke"); 
methodToInvoke?.Invoke(null, null); 
} 
catch(Exception e) 
{ 
Console.WriteLine(e.ToShortDisplayString()); 
} 
} 
public static void TestInvoke() 
{ 
throw (new Exception("Thrown from invoked method.")); 
} 
} 
这 段 代 码 显 示 以 下 文本 。 


当 调 
跟着 
其 值 

















Message: Exception has been thrown by the target of an invocation. 
Type: System.Reflection. TargetInvocationException 

Source: mscorlib 

TargetSite: System.Object InvokeMethod(System.Object, System.Object[], System.Si 
gnature, Boolean) 

**** INNEREXCEPTION START **** 

Message: Thrown from invoked method. 

Type: System.Exception 

Source: CSharpRecipes 

TargetSite: Void TestInvoke() 

**** INNEREXCEPTION END **** 


FH methodToInvoke?.Invoke 方法 时 ， 会 调用 TestInvoke 方法 ， 它 引发 一 个 异常 。 紧 
methodToInvoke 的 问号 是 一 个 null 条 件 运算 符 ， 用 来 处 理 无 法 获得 MethodInfo 时 
为 null 的 情况 。 通 过 这 种 方式 ， 就 不 需要 在 调用 时 编写 null 值 的 检查 语句 。 外 








部 异常 是 TargetInvocationException; 这 是 一 个 通用 异常 ， 当 通过 反射 调用 的 方法 
引发 一 个 异常 时 将 引发 该 异常 。CLR 会 自动 将 调用 的 方法 引发 的 原始 异常 包装 到 
TargetInvocationException 对 象 的 InnerException 属性 中 。 在 这 种 情况 下 ， 由 调用 的 方法 
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引发 的 异常 是 System.Exception 类 型 。 该 异常 显示 在 以 文本 **** INNEREXCEPTIONSTART**** 

开头 的 区 域 后 面 。 

为 了 显示 异常 信息 ， 可 调用 ToShortDisplayString 方法 ， 代 码 如 下 所 示 。 
Console.WriteLine(e.ToShortDisplayString()); 

Exception 的 ToShortDisplayString 扩展 方法 使 用 StringBuilder 创建 关于 异常 以 及 所 

有 内 部 异常 的 信息 串 。WriteExceptionShortDetail 方法 利用 异常 数据 的 特定 部 分 填充 

StringBuilder。 为 了 获取 内 部 异常 ， 可 使 用 GetNestedExceptionList 扩展 方法 ， 代 码 如 下 

所 示 。 


public static string ToShortDisplayString(this Exception ex) 








{ 
StringBuilder displayText = new StringBuilder(); 
WriteExceptionShortDetail(displayText, ex); 
foreach(Exception inner in ex.GetNestedExceptionList()) 
{ 
displayText.AppendFormat("**** INNEREXCEPTION START ****{O}", 
Environment.NewLine) ; 
WriteExceptionShortDetail(displayText, inner); 
displayText.AppendFormat("**** INNEREXCEPTION END ****{Q}{0}", 
Environment.NewLine); 
} 
return displayText.ToString(); 
} 


public static IEnumerable<Exception> GetNestedExceptionList( 
this Exception exception) 


{ 
Exception current = exception; 
do 
{ 
current = current. InnerException; 
if (current != null) 
yield return current; 
} 
while (current != null); 
} 
public static void WriteExceptionShortDetail(StringBuilder builder, Exception ex) 
{ 
builder.AppendFormat("Message: {0}{1}", ex.Message, Environment.NewLine) ; 
builder .AppendFormat("Type: {0}{1}";, ex.GetType(), Environment.NewLine) ; 
builder .AppendFormat('"Source: {0}{1}", ex.Source, Environment.NewLine) ; 
builder.AppendFormat("TargetSite: {0}{1}", ex.TargetSite, 
Environment.NewLine) ; 
} 


5.2.4 参考 
MSDN 文档 中 的 “Type 类 “NULL 条 件 运 算 符 ”和 “MethodInfo 类 ”主题 。 





5.3 创建 新 的 异常 类 型 


5.3.1 问题 


.NET Framework 中 的 所 有 内 置 异 常 都 没有 提供 你 需要 引发 的 异常 的 实现 细节 。 你 需要 创建 
自己 的 异常 类 ， 它 可 以 与 你 的 应 用 程序 以 及 其 他 应 用 程序 无 颖 地 协同 工作 。 无 论 何 时 应 用 
程序 接收 到 这 个 新 异常 ， 它 都 可 以 通知 用 户 在 特定 的 组 件 中 发 生 了 特定 的 错误 。 这 种 报告 
将 极 大 地 减少 调试 问题 所 需 的 时 间 。 


5.3.2 解决 方案 
创建 自己 的 异常 类 。 为 了 说 明 这 一 点 ， 让 我 们 创建 一 个 自 定义 的 异常 类 
RemoteComponentFxception， 它 将 通知 客户 端 应 用 程序 在 远程 服务 器 程序 集中 发 生 了 错误 。 


5.3.3 讨论 
异常 层次 结构 开始 于 Exception 类 ， 从 该 类 派生 出 两 个 类 : ApplicationException 
和 SystemException, SystemException 类 及 其 派生 的 任何 类 是 为 FCL 开发 人 员 预 留 
的 。 大 多 数 和 常见 的 异常 (如 NullReferenceException 或 OverflowException) 都 是 从 
SystemException 派生 而 来 的 。FCL 开发 人 员 为 使 用 .NET 语言 的 其 他 开发 人 员 创 建 了 
ApplicationException 类 ， 用 于 派生 出 他 们 自己 的 异常 。 这 种 划分 让 我 们 可 以 清楚 地 区 
分 用 户 定义 的 异常 与 内 置 的 系统 异常 。 不 过 ，Microsoft 现在 建议 直接 从 Exception, ifi 
不 是 从 ApplicationException 派生 异常 。 没 有 什么 会 能 主动 阻止 你 从 SystemException 
或 ApplicationException 派生 一 个 类 。 但 是 最 好 保持 一 致 ， 并 且 遵 守 如 下 约定 : 总 是 从 
Exception 类 派生 用 户 定义 的 异常 。 
在 确定 异常 的 名 称 时 ， 应 该 遵守 异常 的 命名 约定 。 该 约定 非常 简单 : 决定 异常 的 名 称 ， 并 
在 该 名 称 末尾 添加 单词 Exception (例如 ， 使 用 UnknownException 作为 异常 的 名 称 ， 而 不 
是 仅 使 用 Unknown), 
每 个 用 户 定义 的 异常 都 应 该 包括 至 少 三 个 构造 函数 ， 下 面 将 逐一 介绍 。 这 不 是 一 种 要 求 ， 
但 它 会 使 你 的 异常 类 的 工作 方式 类 似 于 FCL 中 其 他 所 有 异常 类 ， 并 且 可 以 尽量 缩短 其 他 开 
发 人 员 使 用 你 的 新 异常 的 学 习 曲 线 。 
。 默认 构造 函数 
这 个 构造 国 数 不 带 参 数 ， 并 且 只 调用 基 类 的 默认 构造 函数 。 
© 带 有 一 个 参数 (接受 消息 字符 串 ) 的 构造 函数 
这 个 消息 字符 串 将 会 重 写 该 异常 的 Message 字段 的 默认 内 容 。 像 默认 构造 函数 一 样 ， 这 
个 构造 函数 也 会 调用 基 类 的 构造 函数 ， 它 也 接受 一 个 消息 字符 串 作为 它 的 唯一 参数 。 
。 接受 消息 字符 串 和 内 部 异常 作为 参数 的 构造 函数 
将 innerException 参数 中 包含 的 对 象 添加 到 这 个 异常 对 象 的 InnerException 属性 中 。 
像 另 外 两 个 构造 函数 一 样 ， 这 个 构造 函数 也 会 调用 基 类 具有 相同 签名 的 构造 函数 。 
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应 该 创建 一 些 字段 及 其 访问 器 以 保存 异常 特有 的 数据 。 因 为 该 异常 是 因为 在 远程 服务 器 程 
序 集中 发 生 错误 而 引发 的 ， 所 以 将 添加 一 个 私有 字段 来 包含 服务 器 或 服务 的 名 称 。 此 外 ， 
还 将 添加 一 个 公共 的 只 读 属性 用 于 访问 这 个 字段 。 因 为 要 添加 这 个 新 字段 ， 所 以 应 该 添加 
两 个 构造 国 数 ， 它 们 接受 一 个 额外 的 参数 ， 用 于 设置 serverName 字段 的 值 。 

如 果 必 要 ， 可 重 写 其 行为 被 自 定 义 异 常 类 继承 的 任何 基 类 的 成 员 。 例 如 ， 因 为 添加 了 一 个 
新 字段 ， 所 以 需要 确定 是 否 要 为 这 个 异常 把 它 添 加 到 Message 字段 的 默认 内 容 中 。 如 果 是 
这 样 ， 就 必须 重 写 Message 属性 ， 代 码 如 下 所 示 。 

public override string Message => $"{base.Message}{Environment.NewLine}" + 


$"The server ({this.ServerName ?? "Unknown"})" + 
"has encountered an error."; 


注意 在 第 一 行 显示 基 类 中 的 Message 属性 ， 并 在 下 一 行 显示 额外 的 文本 。 这 种 组 织 方式 
考虑 到 用 户 可 能 会 使 用 接受 消息 字符 串 作 为 参数 的 重 载 构造 函数 之 一 来 修改 将 出 现在 
Message 属性 中 的 消息 。 


你 的 异常 对 象 应 该 可 以 序列 化 和 反 序 列 化 。 这 涉及 执行 下 面 两 个 额外 的 步骤 。 


(1) Serializable 特性 添加 到 类 定义 中 。 这 个 特性 指定 类 可 以 序列 化 和 反 序 列 化 。 如 果 
类 中 没有 这 个 特性 ， 并 且 尝 试 序列 化 该 类 ， 就 会 引发 一 个 SertalizationException, 

(2) 如 果 想 控制 如 何 执 行 序列 化 和 反 序列 化 ， 类 就 应 该 实现 ISerializable 接口 ， 并 且 应 该 
为 它 的 单个 成 员 GetObjectData 提供 一 种 实现 。 这 里 实现 它 是 因为 基 类 实现 了 它 ， 这 意 
味 着 如 果 想 序列 化 添加 的 字段 (例如 serverName) ， 就 必须 重新 实现 它 。 

// 用 于 在 序列 化 时 捕获 额外 字段 的 信息 
public override void GetObjectData(SerializationInfo exceptionInfo, 
StreamingContext exceptionContext) 






























































{ 
base.GetObjectData(exceptionInfo, exceptionContext) ; 
exceptionInfo.AddValue("ServerName", this.ServerName); 


} 
此 外 ， 还 需要 一 个 新 的 构造 函数 重 写 ， 它 接受 信息 以 反 序 列 化 该 对 象 ， 代 码 如 下 所 示 。 
// 序列 化 构造 函数 


protected RemoteComponentException(SerializationInfo exceptionInfo, 
StreamingContext exceptionContext) 
: base(exceptionInfo, exceptionContext) 





{ 
} 


this.serverName = exceptionInfo.GetString("ServerName"); 


即使 不 要 求 这 样 做 ， 也 应 该 使 所 有 用 户 定义 的 异常 类 都 是 可 序列 化 和 反 序 
列 化 的 。 这 样 ， 就 可 以 通过 远程 方式 以 及 在 应 用 程序 域 边界 上 正确 地 传播 


EX n 


JF. 

















如 果 要 在 非 托 管 代 码 (比如 COM 对 象 ) 中 捕获 这 个 异常 ， 还 可 以 为 该 异常 设置 HRESULT 
值 。 在 非 托 管 代码 中 捕获 的 异常 将 变 成 一 个 HRESULT 值 。 如 果 异 常 没 有 改变 HRESULT 值 ， 
它 就 默认 为 基 类 异常 的 HRESULT， 就 继承 自 ApplicationException 的 用 户 定 义 的 异常 对 象 
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来 说 ， 它 是 COR E APPLICATION (0x80131600), 。 为 了 改变 默认 的 HRESULT 值 ， 只 需 在 构造 函 
数 中 设置 这 个 字段 的 值 。 下 面 的 代码 演示 了 这 种 技术 。 


public class RemoteComponentException : Exception 


public RemoteComponentException(string message, Exception innerException) 


{ 
public RemoteComponentException() : base() 
HResult = 0x80040321; 
} 
public RemoteComponentException(string message) : 
base(message) 
{ 
HResult = 0x80040321; 
} 
: base(message, innerException) 
{ 
HResult = 0x80040321; 
} 
} 


现在 ，COM 对 象 将 看 到 的 HRESULT 的 值 为 0x80040321。 








重 写 Message 属性 以 将 任何 新 字段 纳入 到 异常 消息 文本 中 通常 是 一 个 好 主意 。 
始终 记 住 ， 要 包括 基 类 的 消息 文本 以 及 添加 到 该 属性 中 的 任何 额外 文本 。 




















此 时 ，RemoteComponentException 类 提供 了 创建 一 个 完整 的 用 户 定义 的 异常 类 所 需 的 一 切 


最 后 指出 一 点 ， 把 所 有 用 户 定义 的 异常 放 在 一 个 单独 的 程序 集中 是 一 个 好 主意 。 这 样 可 以 
更 容易 地 在 其 他 应 用 程序 中 重用 这 些 异 常 。 更 重要 的 是 ， 其 他 应 用 程序 域 和 远程 执行 代码 
还 可 以 正确 地 引发 和 处 理 这 些 异 常 ， 而 不 管 它们 是 在 哪里 引发 的 。 应 该 用 强 名 称 签署 保存 
这 些 异 常 的 程序 集 ， 并 把 它 添 加 到 全 局 程序 集 缓存 (global assembly cache, GAC) 中 ,以 
便 任 何 使 用 或 处 理 这 些 异常 的 代码 可 以 找到 定义 它们 的 程序 集 。 参 见 11.7 节 ， 了 解 关 于 如 





何 执 行 该 任务 的 更 多 信息 。 


























如 果 你 确信 将 要 定义 的 异常 永远 不 会 在 程序 集 外 面 引发 或 处 理 

















在 那里 。 但 是 ， 如 有 果 出 于 某 种 原 
代码 将 不 能 解析 它 。 

















， 那 么 就 可 以 把 异常 定义 留 



































RemoteComponentException 类 的 完整 源 代码 如 例 5-2 所 示 。 


例 5-2: RemoteComponentException 类 


using System; 
using System.IO; 


using System.Runtime.Serialization; 


因 需 要 在 程序 集 外 面 处 理 引 发 的 异常 ， 那 么 最 终 捕获 它 的 
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using System.Runtime.Serialization.Formatters.Binary; 
using System.Security.Permissions; 


[Serializable] 
public class RemoteComponentException : Exception, ISerializable 
s #region Constructors 

// 普通 的 异常 构造 函数 

public RemoteComponentException() : base() 

{ 

} 


public RemoteComponentException(string message) : base(message) 
{ 
} 


public RemoteComponentException(string message, Exception innerException) 
: base(message, innerException) 

{ 

} 


// 接受 新 的 serverName 参 数 的 构造 函数 
public RemoteComponentException(string message, string serverName) : 
base(message) 


{ 
j 


this.ServerName - serverName; 


public RemoteComponentException(string message, 
Exception innerException, string serverName) 
: base(message, innerException) 


{ 
j 
// 序列 化 构造 函数 


protected RemoteComponentException(SerializationInfo exceptionInfo, 
StreamingContext exceptionContext) 
: base(exceptionInfo, exceptionContext) 


this.ServerName = serverName; 


{ 
j 


#endregion // Constructors 


this.ServerName = exceptionInfo.GetString( "ServerName" ) ; 


#region Properties 
// 服务 器 名 称 只 读 属性 


public string ServerName { get; } 


public override string Message => $"{base.Message}{Environment.NewLine}" + 
$"The server ({this.ServerName ?? "Unknown"})" + 
"has encountered an error."; 

#endregion // Properties 


#region Overridden methods 
// ToString 方 法 
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public override string ToString() => 
"An error has occurred in a server component of this client." + 
$"{Environment.NewLine}Server Name: " + 
$"{this.ServerName}{Environment.NewLine}" + 
$"(this.ToFullDisplayString()]"; 


// 用 于 在 序列 化 时 捕获 额外 字段 的 信息 

[SecurityPermission(SecurityAction.LinkDemand, Flags = 
SecurityPermissionFlag.SerializationFormatter)] 

public override void GetObjectData(SerializationInfo info, 
StreamingContext context) 








{ 
base.GetObjectData(info, context); 
info.AddValue("ServerName", this.ServerName) ; 


} 


#endregion // Overridden methods 


public string ToBaseString() => (base. ToString()); 
} 
重 写 的 ToString 方法 中 执行 的 ToFul DisplayString 是 Exception 类 的 一 个 扩展 方法 ， 另 
一 个 扩展 方法 GetNestedExceptionList 用 于 获得 异常 列表 ， 而 WriteExceptionDetail 扩展 
方法 用 于 处 理 每 个 Exception 的 细节 。 


public static string ToFullDisplayString(this Exception ex) 





{ 
StringBuilder displayText = new StringBuilder(); 
WriteExceptionDetail(displayText, ex); 
foreach (Exception inner in ex.GetNestedExceptionList()) 
{ 
displayText.AppendFormat("**** INNEREXCEPTION START ****{O}", 
Environment.NewLine) ; 
WriteExceptionDetail(displayText, inner); 
displayText.AppendFormat("**** INNEREXCEPTION END ****{Q}{0}", 
Environment.NewLine) ; 
} 
return displayText.ToString(); 
} 


public static IEnumerable<Exception> GetNestedExceptionList( 
this Exception exception) 


{ 
Exception current = exception; 
do 
{ 
current = current. InnerException; 
if (current != null) 
yield return current; 
} 
while (current != null); 
} 


public static void WriteExceptionDetail(StringBuilder builder, Exception ex) 


{ 
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builder.AppendFormat("Message: {0}{1}", ex.Message, Environment.NewLine) ; 

builder .AppendFormat('"Type: {0}{1}", ex.GetType(), Environment.NewLine); 

builder.AppendFormat("HelpLink: {0}{1}", ex.HelpLink, Environment.NewLine); 

builder .AppendFormat("Source: {0}{1}", ex.Source, Environment.NewLine) ; 

builder .AppendFormat("TargetSite: {O}{1}", ex.TargetSite, 
Environment.NewLine) ; 

builder .AppendFormat('"Data:{0}", Environment.NewLine) ; 

foreach (DictionaryEntry de in ex.Data) 


builder .AppendFormat("\t{0} : {1}{2}", 
de.Key, de.Value, Environment.NewLine); 


} 
builder .AppendFormat("StackTrace: {0}{1}", ex.StackTrace, 


Environment.NewLine) ; 


} 
例 5-3 中 显示 了 用 于 测试 RemoteComponentException 类 的 部 分 代码 请 生 


例 5-3: 测试 RemoteComponentException 类 
public void TestSpecializedException() 


[E 











{ 

// 生成 用 于 测试 RemoteComponentException 的 innerException 的 内 部 异常 
Exception inner = new Exception("The inner Exception"); 
RemoteComponentException sel = new RemoteComponentException (); 
RemoteComponentException se2 = 

new RemoteComponentException ("A Test Message for se2"); 
RemoteComponentException se3 = 

new RemoteComponentException ("A Test Message for se3", inner); 
RemoteComponentException se4 = 

new RemoteComponentException ("A Test Message for se4", 

"MyServer"); 

RemoteComponentException se5 - 

new RemoteComponentException ("A Test Message for se5", inner, 

"MyServer"); 

// 测试 重 写 的 Message 属 性 
Console.WriteLine(Environment.NewLine + 

"TEST -OVERRIDDEN- MESSAGE PROPERTY"); 
Console.WriteLine("se1.Message == " + se1.Message); 
Console.WriteLine("se2.Message == " + se2.Message); 
Console.WriteLine("se3.Message == " + se3.Message); 
Console.WriteLine("se4.Message == " + se4.Message); 
Console.WriteLine("se5.Message == " + se5.Message); 
// 测试 重 写 的 Tostring 方 法 
Console.WriteLine(Environment.NewLine + 

"TEST -OVERRIDDEN- TOSTRING METHOD"); 
Console.WriteLine("se1.ToString() == " + sei.ToString()); 
Console.WriteLine('"se2.ToString() == " + se2.ToString()); 
Console.WriteLine("se3.ToString() == " + se3.ToString()); 
Console.WriteLine("se4.ToString() == " + se4.ToString()); 
Console.WriteLine("se5.ToString() == " + se5.ToString()); 
Console.WriteLine(Environment.NewLine + "END TEST" + Environment.NewLine); 

} 
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例 5-4 中 展示 了 例 5-3 的 输出 。 


例 5-4: RemoteComponentException 类 显示 的 输出 
TEST -OVERRIDDEN- MESSAGE PROPERTY 
sel.Message == Exception of type 'CSharpRecipes.ExceptionHandling+RemoteComponen 
tException' was thrown. 
A server with an unknown name has encountered an error. 


se2.Message -- A Test Message for se2 

A server with an unknown name has encountered an error. 
se3.Message -- A Test Message for se3 

A server with an unknown name has encountered an error. 
se4.Message -- A Test Message for se4 

The server (MyServer) has encountered an error. 
se5.Message -- A Test Message for se5 


The server (MyServer) has encountered an error. 


TEST -OVERRIDDEN- TOSTRING METHOD 

se1.ToString() == An error has occurred in a server component of this client. 
Server Name: 

Message: Exception of type 'CSharpRecipes.ExceptionHandling+RemoteComponentExcep 
tion' was thrown. 

A server with an unknown name has encountered an error. 


Type: CSharpRecipes.ExceptionHandling+RemoteComponentException 
HelpLink: 

Source: 

TargetSite: 

Data: 

StackTrace: 


se2.ToString() == An error has occurred in a server component of this client. 
Server Name: 

Message: A Test Message for se2 

A server with an unknown name has encountered an error. 

Type: CSharpRecipes.ExceptionHandling+RemoteComponentException 

HelpLink: 

Source: 

TargetSite: 

Data: 

StackTrace: 


se3.ToString() == An error has occurred in a server component of this client. 
Server Name: 

Message: A Test Message for se3 

A server with an unknown name has encountered an error. 

Type: CSharpRecipes.ExceptionHandling+RemoteComponentException 
HelpLink: 

Source: 

TargetSite: 

Data: 

StackTrace: 

**** INNEREXCEPTION START **** 

Message: The Inner Exception 

Type: System.Exception 
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HelpLink: 

Source: 

TargetSite: 

Data: 

StackTrace: 

**** INNEREXCEPTION END **** 


se4.ToString() -- An error has occurred in a server component of this client. 
Server Name: MyServer 

Message: A Test Message for se4 

The server (MyServer) has encountered an error. 

Type: CSharpRecipes.ExceptionHandling+RemoteComponentException 

HelpLink: 

Source: 

TargetSite: 

Data: 

StackTrace: 


se5.ToString() == An error has occurred in a server component of this client. 
Server Name: MyServer 


Message: A Test Message for se5 

The server (MyServer) has encountered an error. 
Type: CSharpRecipes.ExceptionHandling+RemoteComponentException 
HelpLink: 

Source: 

TargetSite: 

Data: 

StackTrace: 

**** INNEREXCEPTION START **** 

Message: The Inner Exception 

Type: System.Exception 

HelpLink: 

Source: 

TargetSite: 

Data: 

StackTrace: 

**** INNEREXCEPTION END **** 

END TEST 


5.3.4 参考 


7500 11.7 (Hl 11.7 45) ; MSDN 文档 中 的 “使 用 用 户 定义 的 异常 ”和 “Exception 28” 
主题 。 


5.4 在 首次 异常 上 中 断 


5.4.1 问题 


你 需要 修正 一 段 引 发 异常 的 代码 中 的 问题 。 不 幸 的 是 ， 异 常 处 理 程序 正在 捕获 异常 ， 你 很 
难 查 明 在 何 时 、 何 处 引发 了 异常 。 
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如 有 果 你 需要 在 第 一 次 引发 异常 的 位 置 单 步调 试 代 码 ， 那 么 在 应 用 程序 有 机 会 处 理 异 常 之 前 
强制 应 用 程序 在 异常 上 中 断 是 非常 有 用 的 。 如 果 应 用 程序 引发 该 异常 但 未 处 理 它 ， 调 试 器 
将 进行 干预 ， 并 在 引发 未 处 理 异 常 的 代码 行 上 中 断 。 在 这 种 情况 下 ， 可 以 查看 引发 异常 的 
环境 。 不 过 ， 如 果 在 引发 异常 时 异常 处 理 程序 是 活动 的 ， 异 常 处 理 程序 将 会 处 理 异 常 并 继 
续 运行 ， 阻止 你 看 到 引发 异常 的 那个 位 置 的 环境 。 这 是 所 有 异常 的 默认 行为 。 


5.4.2 

































































解决 方案 


在 Visual Studio 2015 内 选择 Debug 一 Exceptions 或 者 使 用 Ctrl-Alt-E 组 合 键 ， 将 会 显示 
Exceptions Settings 工具 窗口 (参见 图 5-1)。 从 树 视图 中 选择 你 想 修 改 的 异常 ， 然 后 单 
击 树 视 医 














中 的 复 选 框 。 单 击 OK 按钮 ， 然 后 运行 应 用 程序 。 无 论 应 用 程序 何 时 引发 一 个 





System.ArgumentOutOfRangeException 异常 ， 在 应 用 程序 有 机 会 处 理 该 异常 之 前 ， 调 试 器 将 











在 该 代码 行 上 中 断 。 
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5-1; Exceptions Settings 工具 窗口 














使 用 Exceptions Settings 工具 窗口 ， 可 以 定位 你 想 改变 其 默认 行为 的 特定 异常 或 异常 集 。 该 
对 话 框 具有 三 个 主要 区 域 。 第 一 个 是 TreeView 控件 ， 它 包含 分 类 的 异常 列表 。 使 用 这 个 
TreeView， 可 以 选择 一 个 或 多 个 你 希望 修改 其 行为 的 异常 或 异常 组 。 

这 个 对 话 框 的 下 一 个 区 域 是 TreeView 旁 列 表 中 的 Thrown 列 。 该 列 包含 与 每 个 异常 对 应 的 
复 选 框 ， 在 第 一 次 引发 相应 的 异常 类 型 时 它 人 允许 调试 器 中 断 。 在 这 个 阶段 ， 异 常 被 视 为 首 









































次 异常 。 如 果 在 Thrown 列 中 选中 某 个 复 选 框 ， 当 引发 在 TreeView 控件 中 所 选 的 首次 异常 


类 型 时 ， 








将 强制 调试 器 进行 干预 。 如 果 不 选 中 复 选 框 ， 就 允许 应 用 程序 尝试 处 理 第 一 次 机 


会 的 异常 。 
还 可 以 单 击 窗口 左上 方 的 Filter 图 标 ， 将 异常 视图 得 选 为 只 显示 你 选中 在 首次 异常 时 中 断 























的 所 有 异常 ， 如 图 5-2 所 示 。 
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Exception Settings 














Platform: 




































































Platform: 








< SCS SSS 
























































Exception Settings 





Platform:: 
Platform:: 
Platform:: 
Platform:: 
Platform:: 
Platform:: 
Platform:: 
Platform:: 
Platform:: 
Platform:: 


Platform:: 
Common Language Runtime Exceptions 
4| System.ArgumentOutOfRangeException 
JavaScript Runtime Exceptions 

«| 0x80070005 Access is denied 

Managed Debugging Assistants 

«4| CallbackOnCollectedDelegate 

«4| ContextSwitchDeadlock 


T -| se = PE Search 
Break when Thrown 
4 |4| C++ Exceptions 


AccessDeniedException ^ 
ChangedStateException ^ 
:ClassNotRegisteredException ^ 
COMException ^ 
:DisconnectedException ^ 
FailureException ^ 
InvalidArgumentException ^ 
InvalidCastException ^ 
NotlmplementedException ^ 
NullReferenceException ^ 
OperationCanceledException ^ 
::QutOfBoundsException ^ 
OutOfMemoryException ^ 


Error List Output 











5-2: 筛选 过 的 Exceptions Settings 工具 窗口 


Exceptions Settings 工具 窗口 上 部 还 提供 了 一 个 搜索 条 ， 人 允许 你 搜索 窗口 中 的 异常 。 如 果 在 























窗口 中 输入 argumentnullexception,， 会 看 到 选择 缩 罕 为 只 包含 匹配 文本 的 异常 ， 如 图 5-3 


所 示 。 








Exception Settings 





























Exception Settings 





Y-|+-# 


argumentnullexception 


Break when Thrown 
4 Common Language Runtime Exceptions 


System.ArgumentNullException 
System.Management.Automation.PSArgumentNullException 


Error List Output 


~ ax 














5-3: Exceptions Settings 工具 窗口 搜索 


要 把 用 户 定义 的 异常 添加 到 Exception Settings 中 ， 可 单 击 Add 按钮 。 将 显示 如 


的 对 话 框 。 





Z] 











5-4 所 示 











Microsoft Visual Studio 医 下 


This feature is not currently available in the new Exception Settings Window. 


Would you like to open the legacy Exceptions Dialog to perfom this action? 





Yes [ No 

















图 5-4, 把 用 户 定义 的 异常 添加 到 Exception Settings 





单 击 Yes 使 用 原始 的 Exceptions 对 话 框 ， 如 图 5-5 所 示 。 








Exceptions ? 


Break when an exception is: Add... 


Name Thrown User-unhandied ^ 
4 g 
由 - JScript Exceptions L 
5- System 
System.AccessViolationException 口 
| System.AggregateException t Find Net 
一 SystemAppDomainUnloadedException 
System ApplicationException 
i System.Argument£xception 
System.ArgumentNullException H 
一 System ArgumentOutOfRangeException v] 
System.ArithmeticException 
| System.ArrayTypeMismatchException 
System.BadlmageFormatException 








88 
z 
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Reset All 
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图 5-5; Exceptions 对 话 框 


这 个 对 话 框 包含 两 个 有 用 的 按钮 ，Find 和 Find Next。 它 们 允许 查找 一 个 异常 而 不 用 深入 检 
查 TreeView 控件 ， 并 且 可 以 根据 自己 的 需要 进行 查找 。 此 外 ， 还 有 另外 三 个 按钮 (Reset 
All, Add 和 Delete) 分 别 用 于 复位 到 原始 状态 ， 以 及 添加 和 删除 用 户 定义 的 异常 。 


例如 ， 你 可 以 创建 自己 的 异常 ， 就 像 在 5.3 市 中 所 做 的 那样 ， 并 且 把 该 异常 添加 到 列表 
中 。 必 须 把 任何 像 这 样 的 托管 异常 添加 到 名 为 Common Language Runtime Exceptions 的 
TreeView 节点 下 。 这 一 设置 告诉 调试 器 这 是 一 个 托管 异常 ， 并 且 以 托管 异常 的 方式 对 它 进 
行 处 理 。 图 5-6 显示 了 添加 自 定 义 的 异常 。 

















New Exception ? E3] | 


Type: Common Language Runtime Exceptions v OK 











Cancel 














Name: JebuggingAndExceptionHandling.RemoteComponentExceptior| 














图 5-6: 将 一 个 用 户 定义 的 异常 添加 到 Exceptions 对 话 杠 
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在 该 对 话 框 的 Name 字段 中 输入 异常 的 名 称 ， 包 括 其 准确 的 类 名 以 及 完整 的 命名 空间 作用 
域 。 不 要 在 该 名 称 中 追加 任何 其 他 信息 ， 比 如 它 驻 留 的 命名 空间 以 及 它 秽 套 的 类 名 。 如 果 
这 样 做 ， 在 引发 异常 时 调试 器 将 无 法 看 到 它 。 单 击 OK 按钮 ， 将 异常 置 于 TreeView 中 的 
Common Language Runtime Exceptions 节点 下 。 在 添加 用 户 定 义 的 异常 之 后 ，Exceptions 对 
话 框 看 起 来 如 图 5-7 所 示 。 
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5-7: 将 用 户 定义 的 异常 添加 到 TreeView 中 之 后 的 Exceptions 对 话 框 


Delete 按钮 用 于 删除 添加 到 TreeView 中 的 所 有 已 选中 用 户 定义 的 异常 。Reset All 按钮 用 于 
删除 添加 到 TreeView 中 的 所 有 用 户 定 义 的 异常 。 选 中 Thrown 列 中 的 复 选 框 ， 当 引发 相应 
的 异常 类 型 时 将 会 使 调试 器 停 下 。 

还 有 另外 一 个 设置 可 能 会 影响 异常 调试 : Just My Code ( 详 见 图 5-8)。 应 该 关闭 这 个 设置 ， 
以 便 在 调试 时 可 以 最 清晰 地 看 到 应 用 程序 中 实际 发 生 的 事情 ， 当 启用 此 设置 时 ， 将 无 法 看 
到 代码 调用 的 框架 代码 的 相关 行为 。 能 够 看 到 你 的 代码 调 入 了 框架 的 何 处 ， 以 及 何 处 离开 
框架 代码 是 非常 有 教育 意义 的 ， 能 够 帮助 你 更 好 地 理解 你 正在 调试 的 问题 。 该 设置 位 于 
Visual Studio 2015 中 的 Tools\Options\Debugging\General 之 下 。 
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Search Options (Ctrl+ 日 p General 
Task List ^ V| Ask before deleting all breakpoints 
Web Browser | Break all processes when one process breaks 
b Projects and Solutions Break when exceptions cross AppDomain or managed/native boundaries (M 
b Source Control v| Enable address-level debugging 
b TextEditor Show disassembly if source is not available 
4 Debugging «| Enable breakpoint filters 
General V| Enable the exception assistant 
Edit and Sua yj Unwind the call stack on unhandled exceptions 
ESI Enable Just My Code 
SED Show all members for non-user objects in variables windows (Visual Basi 
Performance Tools 
| Warn if no user code on launch (Managed only) 
Symbols : 
3 Enable .NET Framework source stepping 
b IntelliTrace Js " d tors (M. d 
pepetormance : ep over properties and operators (| anagec only) 
AEE TOE Enable property evaluation and other implicit function calls 
[V]. Call «trina-conversion function on obiects in variables windows 
b FfTools < > 
b Graphics Diagnostics 
OK | Cancel 

















图 5-8; 禁用 Just My Code 设置 


5.4.3 参考 


MSDN 文档 中 的 “异常 处 理 (调试 )” 主 题 。 


5.5 处理 从 异步 委托 中 引发 的 异常 





5.5.1 问题 





5.5.2 ”解决 方案 





using System; 
using System. Threading; 


public class AsyncAction 


( 


当 异 步 使 用 委托 时 ， 如 果 该 委托 引发 任何 异常 ， 你 都 希望 得 到 通知 。 


在 try-catch 语句 块 中 包装 委托 的 EndInvoke 方法 ， 代 码 如 下 所 示 。 


public void PollAsyncDelegate() 


{ 


// 创建 一 个 异步 委托 以 调用 Method1, 并 调用 委托 的 


// BeginInvoke 方 法 


AsyncInvoke MI = new AsyncInvoke(TestAsyncInvoke.Method1) ; 
TAsyncResult AR = MI.BeginInvoke(null, null); 
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// 轮 循 直 到 异步 委托 完成 
while (!AR.IsCompleted) 





System. Threading. Thread.Sleep(100) ; 
Console.Write('.'); 


j 


Console.WriteLine("Finished Polling"); 
// 调用 异步 委托 的 EndInvoke 方 法 
try 


t 
int RetVal - MI.EndInvoke(AR); 
Console.WriteLine("RetVal (Polling): " + RetVal); 


catch (Exception e) 


t 
j 


Console.WriteLine(e.ToString()); 


} 
} 








z 











public delegate int AsyncInvoke(); 


public class TestAsyncInvoke 


{ 
public static int Method1() 
{ 
throw (new Exception("Methodi")); // 模拟 一 个 引发 的 异常 
} 
} 


5.5.3 讨论 


而 的 代码 定义 了 AsyncInvoke 委托 和 异步 调用 的 静态 方法 TestAsyncInvoke.Method1, 


如 果 PollAsyncDelegate 方法 中 的 代码 不 包含 对 委托 的 EndInvoke 方法 的 调用 ， 在 Methodi 
中 引发 的 异常 将 会 被 简单 地 丢弃 并 且 永 远 不 会 被 捕获 ,或 者 如 果 应 用 程序 绑 定 了 顶级 异常 
处 理 程序 (参见 范例 52、 范 例 5.7 和 范例 5.8， 即 5.2 节 、5.7 节 和 5.8 节 )， 就 会 捕获 异 











常 。 如 果 调 用 EndInvoke， 那 么 异常 将 在 调用 EndInvoke 时 触发 并 且 可 以 在 那 是 








种 行为 是 有 意 这 样 设计 的 ， 对 于 线程 发 生 的 所 有 未 处 理 的 异常 ， 线 程 会 立即 返回 





池 ， 并 且 会 丢失 异常 。 











Burt 











到 线程 


如 果 通 过 委托 异步 调用 的 方法 引发 一 个 异常 ， 捕 获 该 异常 的 唯一 方式 是 包括 对 委托 的 
EndInvoke 方法 的 调用 ， 并 把 该 调用 包装 在 一 个 异常 处 理 程序 中 。 必 须 调用 EndInvoke 方法 
获取 异常 委托 的 结果 ， 事 实 上 ， 即 使 没有 任何 结果 ， 也 必须 调用 EndInvoke 方法 。 可 以 通 

















过 委托 的 返回 值 或 者 任何 ref 或 out 参数 获得 这 些 结果 。 


5.5.4 参考 





有 关 在 应 用 程序 中 绑 定 顶级 异常 处 理 程序 的 信息 ， 参 见 范 例 5. 2、 范例 5.7 和 范例 5.8， 即 





5275. 5.7 节 和 5.8 T. 





fe 
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5.6 ”利用 Exception.Data 为 异常 提供 所 需 的 额外 


= 
E 
5.6.1 问题 
你 想 随 异常 一 起 发 送 一 些 额外 的 信息 。 


5.6.2 ”解决 方案 
使 用 System. Exception 对 象 的 Data 属性 ， 存 储 与 异常 有 关 的 键 值 对 信息 。 

例如 ， 假 定 有 一 个 System.ArgumentException 将 要 从 某 个 代码 区 域 中 引发 ， 而 且 你 想 让 其 
中 包括 底层 的 原因 以 及 它 需 要 花费 的 时 间 长 度 。 可 以 在 Exception.Data 属性 中 添加 两 个 键 
值 对 ， 通 过 在 索引 器 中 指定 键 然后 赋值 。 
在 下 面 的 示例 中 ， 异 常 对 象 的 Data 属性 使 用 "Cause" 和 "Length" 作为 它 的 键 。 一 旦 在 
Data 集合 中 建立 了 这 些 数 据 项 ， 就 可 以 引发 异常 并 捕获 它 ， 并 且 可 以 在 后 续 的 catch 块 中 
添加 更 多 数据 ， 以 便 满足 与 将 要 遍历 的 异常 一 样 多 层次 的 异常 处 理 。 












































try 
{ 
try 
{ 
try 
{ 
try 
{ 
ArgumentException irritable = 
new ArgumentException("I'm irritable!"); 
irritable.Data["Cause"]="Computer crashed"; 
irritable.Data["Length"]=10; 
throw irritable; 
} 


catch (Exception e) 


// 确定 是 否 可 处 理 
if(e.Data.Contains("Cause")) 
e.Data["Cause"]="Fixed computer" 





throw; 
} 
catch (Exception e) 
{ 
e.Data["Comment"]-"Always grumpy you are"; 
throw; 
} 


catch (Exception e) 


{ 
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e.Data["Reassurance"]-"Error Handled"; 
throw; 


} 


最 后 的 catch 语句 块 可 以 选 代 Exception. Data 集合 并 显示 所 有 自 初 始 异常 被 引发 后 在 Data 
集合 中 收集 的 支持 数据 。 


catch (Exception e) 


{ 
Console.WriteLine("Exception supporting data:"); 
foreach(DictionaryEntry de in e.Data) 
{ 
Console.WriteLine("\t{O} : {1}",de.Key,de.Value); 
} 
} 


5.6.3 讨论 
Exception .Data 是 一 个 支持 IDictionary 接口 的 对 象 。 使 用 该 对 象 可 以 执行 以 下 操作 。 


。 添加 和 删除 名 称 / 值 对 。 

。 清除 内 容 。 

。 查找 集合 ， 看 看 它 是 否 包含 某 个 键 。 

。 获得 一 个 IDictionaryEnumerator 用 于 遍历 集合 项 目 。 
。 使 用 键 索 引 到 集合 。 

。 单独 访问 所 有 键 和 所 有 值 的 ICollection, 


添加 到 Exception.Data 的 数据 项 需要 是 Serializable， 否 则 在 添加 到 集合 时 
将 引发 ArgumentException。 如 果 你 要 把 一 个 类 添加 到 Exception.Data， 请 将 
其 标记 为 Serializable 并 且 确 保 它 是 可 序列 化 的 。 











public void TestExceptionDataSerializable() 


{ 
Exception badMonkey = 
new Exception("You are a bad monkey!"); 
try 
{ 
badMonkey.Data["Details"] = new Monkey(); 
} 
catch (ArgumentException aex) 
{ 
Console.WriteLine(aex.Message) ; 
} 
} 





//[Serializable] // 取消 注释 以 使 其 可 序列 化 
public class Monkey 
{ 


} 





public string Name { get; } = "George"; 
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能 够 把 特定 于 代码 的 数据 附加 到 系统 异常 上 是 一 件 非常 方便 的 事情 ， 因 为 在 发 生 错误 时 它 
允许 更 完整 地 查看 代码 中 所 发 生 的 事情 。 它 可 以 给 可 怜 的 人 (可 能 是 你 自己 ) 提供 更 多 的 
信息 ， 帮 助 他 们 首先 查 明 为 什么 会 引发 异常 ， 提 供 修正 它 的 更 好 机 会 。 在 引发 异常 时 给 你 
自己 和 你 的 团队 提供 一 点 额外 的 信息 ， 你 不 会 后 悔 这 样 做 的 。 

















5.6.4 参考 
MSDN 文档 中 的 “Exception.Data 属性 ”主题 。 


5.7 在 WinForms 应 用 程序 中 处 理 未 经 处 理 的 异常 


5.7.1 问题 


你 有 一 个 基于 WinForms 的 应 用 程序 ， 你 想 捕获 并 记录 其 中 任何 线程 上 的 任何 未 经 处 理 的 
异常 。 


5.7.2 解决 方案 


你 需要 为 System.Windows.Forms.Application.ThreadException 事件 和 System.AppDomatin . 
UnhandledException 事件 挂 接 处 理 程序 。 这 两 个 事件 都 需要 挂 接 ， 因 为 Framework 中 的 
WinForms 支持 本 身 会 做 许多 异常 捕获 工作 。 它 会 公开 System.Windows.Forms.Application. 
ThreadException 事件 ， 人 允许 获取 WinForms 及 其 事件 的 UI 线程 上 发 生 的 任何 未 经 处 理 的 
异常 。 不 要 被 其 名 称 所 欺骗 ，System.Windows.Forms.Application.ThreadException 事件 
处 理 程序 不 会 捕获 程序 构造 的 工作 者 线程 或 者 来 自 ThreadPool 线程 池 中 工作 者 线程 上 未 
经 处 理 的 异常 。 为 了 捕获 WinForms 应 用 程序 中 发 生 未 捕获 异常 的 所 有 可 能 路 径 ， 需 要 
为 System.AppDomain.UnhandledException 事件 挂 接 一 个 处 理 程序 (System.Windows.Forms. 
Application.ThreadException 事件 会 捕获 UI 线程 中 的 异常 ) o 

为 了 挂 接 必要 的 事件 处 理 程序 以 捕获 WinForms 应 用 程序 中 所 有 未 经 处 理 的 异常 ， 可 在 应 
用 程序 中 的 Main 函数 中 添加 以 下 代码 。 


static void Main() 


( 





























































































































// 添加 事件 处 理 程序 以 捕获 主 UI 线程 中 发 生 的 所 有 异常 
Application.ThreadException += 
new ThreadExceptionEventHandler (OnThreadException) ; 




















// 为 应 用 程序 域 中 除 UI 线 程 之 外 的 其 他 所 有 线程 
// 添加 事件 处 理 程序 
AppDomain.CurrentDomain.UnhandledException += 

new UnhandledExceptionEventHandler(CurrentDomain UnhandledException); 














Application.EnableVisualStyles(); 
Application.Run(new Formi()); 
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使 用 AppDomain.CurrentDomain 的 属性 将 System. AppDomain.UnhandledException 事件 处 理 
程序 挂 接 到 当前 的 AppDomain， 这 一 属性 允许 你 访问 当前 的 AppDomain。 通 过 Application. 
ThreadException 属性 访问 应 用 程序 的 ThreadException 处 理 程序 。 


在 CurrentDomain UnhandledException 和 OnThreadException 处 理 程序 方法 中 建立 事件 处 
里 程序 人 代码。 有关 UnhandledExceptionEventHandler 的 更 多 信息 ， 请 参见 范例 5.8 (BI 5.8 
75), ThreadExceptionEventHandler 接收 发 送 方 对 象 和 一 个 ThreadExceptionEventArgs 对 
象 。ThreadExceptionEventArgs 包含 一 个 Exception 属性 ， 它 包含 来 自 WinForms UI 线程 
的 未 经 处 理 的 异常 。 

// 处 理 其 他 所 有 线程 的 异常 事件 


static void CurrentDomain_UnhandledException(object sender, 
UnhandledExceptionEventArgs e) 



































































































































{ 
// 仅 是 显示 异常 详细 信息 
MessageBox. Show("CurrentDomain_UnhandledException: " + 
e.ExceptionObject.ToString()); 
} 


// 处 理 来 自 UI 线 程 的 异常 事件 


static void OnThreadException(object sender, ThreadExceptionEventArgs 七 ) 


























// 仅 是 显示 异常 详细 信息 
MessageBox. Show('"OnThreadException: 


+ t.Exception.ToString()); 


5.7.3. Wit 

异常 是 在 NET 中 传达 错误 的 主要 方式 ， 因 此 在 构建 应 用 程序 时 ， 必 须 包 含 未 经 处 理 异常 
的 最 后 一 道 防 线 。 未 经 处 理 的 异常 将 会 使 程序 崩溃 〈 即 使 在 NET 中 看 起 来 稍 好 一 点 ) ;你 
可 不 希望 给 自己 的 客户 留 下 这 种 印象 。 为 所 有 未 经 处 理 的 异常 挂 接 一 个 事件 处 理 程序 是 
种 良好 的 做 法 。AppDomain.UnhandledException 事件 就 是 一 个 非常 好 的 选择 ， 但 是 不 得 不 
处 理 另 外 一 个 事件 也 不 是 世界 未 日。 在 为 AppDomain.UnhandledException 和 Application. 
ThreadException 编码 事件 处 理 程序 时 ， 可 以 轻松 地 调用 单个 处 理 程序 ， 把 异常 信息 写 到 导 
件 日 志 、 调 试 流 或 自 定 义 的 跟踪 日 志 中 ， 其 至 给 你 发 送 一 封 带 有 该 信息 的 电子 邮件 。 其 可 
能 性 受到 的 唯一 限制 是 ， 你 希望 采用 什么 方式 来 处 理 任 何 程序 可 能 发 生 的 错误 。 
























































3H 















































574 ”参考 
MSDN 文档 中 的 “ThreadExceptionEventHandler 委托 ”和 “UnhandLedExceptionEventHandLer 


5.8 在 WPF 应 用 程序 中 处 理 未 经 处 理 的 异常 


5.8.1 问题 
你 有 一 个 基于 Windows Presentation Foundation (WPF) 的 应 用 程序 ， 你 想 捕 获 和 记录 其 中 
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任何 线程 上 任何 未 经 处 理 的 异常 。 


5.8.2 ”解决 方案 


为 了 挂 接 必要 的 事件 处 理 程序 ， 以 捕获 WPF 应 用 程序 中 所 有 未 处 理 的 异常 ， 可 以 在 应 用 
程序 的 App.xaml 文件 中 添加 以 下 代码 。 


<Application x:Class="UnhandledWPFException. App" 
xmlns-"http://schemas .microsoft.com/winfx/2006/xaml/presentation" 
xmlns:xz"http://schemas .microsoft.com/winfx/2006/xaml" 
StartupUri-"Windowi1.xaml" 
DispatcherUnhandledException-"Application DispatcherUnhandledException"» 
«Application.MainWindow» 

«Window /» 

</Application.MainWindow> 
«Application.Resources» 
</Application.Resources> 

</Application> 

















E 














然后 ， 在 对 应 的 App.xaml.cs 代码 文件 中 ,添加 Application DispatcherUnhandledException 
方法 ， 用 于 处 理 未 处 经 理 的 异常 。 


private void Application_DispatcherUnhandledException(object sender, 
System.Windows. Threading.DispatcherUnhandledExceptionEventArgs e) 


// 将 异常 信息 记录 到 事件 日 志 中 

EventLog.WriteEntry("UnhandledWPFException Application", 
e.Exception.ToString(), EventLogEntryType.Error); 

// 通知 用 户 发 生 的 异常 

MessageBox.Show("Application DispatcherUnhandledException: 
e.Exception.ToString()); 

// 标明 已 经 处 理 了 异常 

e.Handled = true; 

// 关闭 应 用 程序 

this. Shutdown(); 








+ 





5.8.3 讨论 

Windows Presentation Foundation 为 .NET 平台 创建 基于 Windows 的 应 用 程序 提供 了 另外 一 
种 方法 。 为 了 防止 用 户 看 到 不 雅 观 的 未 经 处 理 的 异常 ， 需 要 在 WPF 中 编写 一 些 代 码 ， 如 
同 在 WinForms 中 一 样 [参见 范例 5.7 ( 即 5.7 节 )， 了 解 如 何在 WinForms 中 实现 这 一 点 ] 。 
System.Windows.Application 类 是 基于 WPF 的 应 用 程序 的 基 类 ， 通 其 
DispatcherUnhandledException 事件 可 以 处 理 未 经 处 理 的 异常 。 通 过 在 App.xaml 文件 中 指 
定 处 理事 件 的 方法 来 建立 这 个 事件 处 理 程序 ， 如 下 所 示 。 

DispatcherUnhandledException="Application_DispatcherUnhandledException"> 

也 可 以 直接 在 代码 中 建立 这 个 事件 处 理 程序 ， 而 不 是 采用 XAML 方式 ， 通 过 在 XAML 文 
件 中 添加 Startup 事件 处 理 程序 (Microsoft 建议 在 WPF 应 用 程序 中 的 此 处 添加 初始 化 代 
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码 )， 如 下 所 示 。 


«Application x:Class-"UnhandledWPFException.App" 
xmlns-"http://schemas.microsoft.com/winfx/2006/xaml/presentation 
xmlns:xz"http://schemas .microsoft.com/winfx/2006/xaml" 
StartupUri-"Window1.xaml" 

Startup-"Application Startup" » 
«Application.MainWindow» 
«Window /» 
</Application.MainWindow> 
«Application.Resources» 


</Application.Resources> 
</Application> 





在 Startup 事件 中 ， 为 DispatcherUnhandledException 建立 事件 处 理 程 序 ， 如 下 所 示 。 


private void Application_Startup(object sender, StartupEventArgs e) 


{ 
this.DispatcherUnhandledException += 
new System.Windows. Threading.DispatcherUnhandledExceptionEventHand Ler ( 
Application DispatcherUnhandledException); 
} 



































这 非常 适合 为 WPF 应 用 程序 处 理 异 常 ， 只 需 挂 接 事 件 并 获取 传送 给 单个 处 理 








程序 的 所 























有 未 处 理 的 异常 即 可 ， 对 吧 ? 不 对 。 就 像 WinForms 应 用 程序 中 所 需要 的 那样 ， 如 果 有 
任何 代码 在 任何 非 UL 线程 上 运行 【几乎 总 会 出 现 这 种 情况 )， 仍 然 需要 为 AppDomain 的 
AppDomain.UnhandledException 事件 挂 接 处 理 程序 ， 用 于 捕获 非 UI 线程 上 的 那些 异常 。 为 




















In 











了 实现 此 操作 ， 对 App.xaml.cs 文件 进行 以 下 更 新 。 


/// <summary> 

/// Interaction logic for App.xaml 

/// </summary> 

public partial class App : Application 


{ 


7 








private void Application_DispatcherUnhandledException(object sender, 


System.Windows.Threading.DispatcherUnhandledExceptionEventArgs e) 


// 标明 已 经 处 理 了 异常 
e.Handled = true; 
ReportUnhandledException(e.Exception); 





} 
private void Application_Startup(object sender, StartupEventArgs e) 
{ 
// WPF UI 异常 
this.DispatcherUnhandledException += 
new System.Windows. Threading.DispatcherUnhandledExceptionEventHandler ( 
Application DispatcherUnhandledException); 
// 那些 线程 上 的 异常 
AppDomain.CurrentDomain.UnhandledException += 
new UnhandledExceptionEventHandler(CurrentDomain UnhandledException); 
} 





private void CurrentDomain_UnhandledException(object sender, 
UnhandledExceptionEventArgs e) 
































{ 
ReportUnhandledException(e.ExceptionObject as Exception); 
} 
private void ReportUnhandledException(Exception ex) 
{ 
// 将 异常 信息 记录 到 事件 日 志 中 
EventLog.WriteEntry("UnhandledWPFException Application", 
ex.ToString(), EventLogEntryType.Error); 
// 通知 用 户 发 生 的 异常 
MessageBox.Show("UnhandLed Exception: " + ex.ToString()); 
// 关闭 应 用 程序 
this.Shutdown(); 
} 


5.84 参考 


范例 57 (BN 5.7 45), EAR MSDN X 4 AY "DispatcherUnhandledException 事件 ”和 
"AppDomain.UnhandledException 事件 ”主题 。 


5.9 ”确定 一 个 进程 是 否 停止 了 响应 


5.9.1 问题 


你 需要 监视 一 个 或 多 个 进程 ， 以 确定 用 户 界 面 是 否 停 止 了 对 系统 的 响应 。 这 一 功能 类 似 于 
Task Manager 中 基于 应 用 程序 的 状态 显示 文本 Responding 或 Not Responding 的 那 一 列 。 


5.9.2 解决 方案 

使 用 例 5-5 中 所 示 的 GetProcessState 方法 和 ProcessRespondingState 枚 举 ， 确 定 进程 是 否 
停止 了 响应 。 

例 5-5: 确定 进程 是 否 停止 了 响应 


public enum ProcessRespondingState 














{ 
Responding, 
NotResponding, 
Unknown 

} 


public static ProcessRespondingState GetProcessState(Process p) 


{ 
if (p.MainWindowHandle == IntPtr.Zero) 


{ 


Trace.WriteLine($"{p.ProcessName} does not have a MainWindowHandle"); 
return ProcessRespondingState.Unknown; 
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else 








// 这 一 进程 拥有 一 个 MainWindowHandle 
if (!p.Responding) 

return ProcessRespondingState.NotResponding; 
else 

return ProcessRespondingState.Responding; 








5.9.3 讨论 

GetProcessState 方法 接受 标识 一 个 进程 的 单一 参数 process。 然 后 在 process 参数 表示 的 
Process 对 象 上 调用 Responding 属性 。 该 方法 返回 一 个 ProcessRespondingState 枚 举 值 ， 
指示 一 个 进程 目前 是 响应 (Responding), 、 未 响应 (NotResponding) 或 者 因为 没有 主 窗口 句 
柄 而 不 能 确定 该 进程 是 否 在 响应 (Unknown), 


如 果 正 在 处 理 的 进程 没有 MainWindowHandle, Jill] Responding 属性 总 是 返回 true。 像 Idle、 
spoolsv, Rundll32 和 svchost 这 样 的 进程 并 设 有 主 窗口 句柄 ， 因 此 Responding 属性 总 会 六 
它们 返回 true。 为 了 清除 这 些 进 程 ， 可 以 使 用 Process 类 的 MainWindowHandle 属性 ， 它 将 
为 进程 返回 主 窗口 的 句柄 。 如 果 该 属性 返回 6， 进程 就 没有 主 窗口 。 


为 了 确定 一 台 机 器 上 的 所 有 进程 是 否 都 在 响应 ， 可 以 如 下 所 示 调 用 GetProcessstate 方法 。 


var processes = Process.GetProcesses().ToArray(); 
Array.ForEach(processes, p => 


{ 
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var processState = GetProcessState(p); 


switch (processState) 
{ 
case ProcessRespondingState.NotResponding: 
Console.WriteLine($"{p.ProcessName} is not responding."); 
break; 
case ProcessRespondingState.Responding: 
Console.WriteLine($"{p.ProcessName} is responding."); 
break; 
case ProcessRespondingState.Unknown: 
Console.WriteLine( 
$"{p.ProcessName}'s state could not be determined."); 
break; 
} 
]); 


这 段 代 码 将 遍历 系统 中 目前 在 运行 的 所 有 进程 。Process 类 的 静态 方法 GetProcesses 不 
带 参数 ， 并 且 和 返回 Process 对 象 的 数组 ， 包 含 系统 中 运行 的 所 有 进程 的 信息 。 然 后 把 
每 个 Process 对 象 传 入 GetProcessState FAH, ME C E EM by, Process 类 上 
的 其 他 用 于 获取 Process 对 象 的 的 静态 方法 是 GetProcessById, GetCurrentProcess 和 


GetProcessesByName, 























5.9.4 参考 


MSDN 文档 中 的 “Process 类 ”主题 。 


5.10 在 应 用 程序 中 使 用 事件 日 志 


5.10.1 问题 


你 需要 给 应 用 程序 添加 一 种 能 力 ， 用 来 记录 在 应 用 程序 中 发 生 的 事件 ， 比 如 启动 、 关 闭 、 
关键 错误 ， 甚 至 违反 安全 的 情况 。 除 了 读 、 写 日 志 之 外 ， 你 还 需要 其 有 在 事件 日 志 中 创 
建 、 清 除 、 关 闭 和 删除 日 志 的 能 

应 用 程序 也 许 会 需要 记录 多 个 日 志 。 例 如 ， 当 应 用 程序 中 发 生 特定 的 事件 〈 比 如 启动 和 关 
Hl) 时 ， 应 用 程序 可 能 使 用 自 定义 的 日 志 来 跟踪 它们 。 除 了 自 定义 的 日 志 之 外 ， 应 用 程序 
还 可 能 利用 事件 日 志 系 统 中 已 经 构建 的 安全 日 志 来 读 、 写 应 用 程序 中 发 生 的 安全 事件 。 

当 需 要 在 本 地 计算 机 上 创建 和 维护 一 个 日 志 并 且 需 要 在 远程 机 器 上 创建 和 维护 另 一 个 复制 
的 日 志 时 ， 对 多 个 日 志 的 支持 就 会 带 来 方便 。 这 台 远 程 机 器 可 能 包含 应 用 程序 在 每 个 用 户 
的 机 器 上 的 所 有 运行 实例 的 日 志 。 如 果 在 应 用 程序 中 违反 了 安全 ， 管 理 员 可 以 使 用 这 些 日 
志 快 速 查找 发 生 或 发 现 的 任何 问题 。 事 实 上 ， 应 用 程序 可 以 在 远程 管理 机 器 的 后 台 运 行 ， 
监视 从 任何 用 户 的 机 器 写 到 这 个 日 志 的 特定 日 志 条 目 。 范 例 13.6 (BIl 13.6 13). 使 用 一 种 事 
件 机 制 来 监视 写 到 事件 日 志 的 条 目 ， 并 且 可 以 轻松 地 用 于 增强 本 范例 。 


5.10.2 解决 方案 
使 用 Microsoft Windows 操作 系统 中 内 建 的 事件 日 志 ， 来 记录 非 频 繁 发 生 的 特定 事件 。 


不 要 用 大 量 不 同 条 目 填 满 事件 日 志 ， 你 可 以 通过 启用 或 禁用 追踪 对 条 目 进 行 
处 理 。 事 件 日 志 必 须 包含 错误 信息 ， 其 次 是 非常 重要 的 项 目 ,但 并 非 所 有 内 
容 都 应 该 写 入 到 事件 日 志 中 。 明 智 地 选择 何 时 写 和 人 事件 日 志 ， 才 能 在 寻找 线 
索 时 不 需要 对 所 有 日 志 进 行 排序 。 
































































































































il 5-6 中 所 示 的 AppEvents 类 包含 在 应 用 程序 中 创建 和 使 用 事件 日 志 所 需 的 所 有 方法 。 
例 5-6: 创建 和 使 用 事件 日 志 


using System; 
using System.Diagnostics; 





public class AppEvents 
{ 
// 如 果 在 试图 读 取 注册 表 项 (Security Log) 时 遇 到 SecurityException， 
// 按照 如 下 指引 步骤 : 
// 1) 打开 注册 表 编辑 器 (搜索 regedit 或 者 在 Run 提 示 符 下 键入 regedit 并 按 回 车 ) 
// 2) 查找 到 以 下 键 : 
// HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Eventlog\Security 
// 3) 右键 单 击 这 一 项 ,然后 选择 Permissions 
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// 4) 添加 当前 登入 的 用 户 , 并 赋予 用 户 Read 权 限 


// 如 果 在 试图 写 入 事件 日 志 时 遇 到 SecurityException 

// "Requested registry access is not allowed." ,那么 说 明 事 件 产 还 没有 创建 
// 尝试 针对 自 定义 事件 重新 运行 EventLogInstaller， 

// 对 于 本 示例 代码 ,运行 "%WINDOWS%\Microsoft.NET\Framework\v4.0.30319\ 
// InstallUtil.exe AppEventsEventLogInstallerApp.dll" 

// 如 果 你 刚刚 运行 过 它 , 可 能 需要 等 待 一 小 会 儿 , 直 到 Windows 完 成 创建 

// 并 且 识 别 了 添加 的 日 志 















































const string localMachine = 
// 构造 函数 
public AppEvents(string logName) : 

this(logName, Process.GetCurrentProcess().ProcessName) 


{ } 


public AppEvents(string logName, string source) : 
this(logName, source, localMachine) 


t3 


public AppEvents(string logName, string source, 
string machineName - localMachine) 


{ 

this.LogName = logName; 

this.SourceName = source; 

this.MachineName = machineName; 

Log = new EventLog(LogName, MachineName, SourceName) ; 
} 


private EventLog Log { get; set; } = null; 

public string LogName { get; set; } 

public string SourceName { get; set; } 

public string MachineName { get; set; } = localMachine; 
// 方法 


public void WriteToLog(string message, EventLogEntryType type, 
CategoryType category, EventIDType eventID) 





{ 
if (Log == null) 
throw (new ArgumentNullException(nameof(Log), 
"This Event Log has not been opened or has been closed.")); 
EventLogPermission evtPermission - 
new EventLogPermission(EventLogPermissionAccess.Write, MachineName); 
evtPermission.Demand(); 
/] 如 果 此 处 遇 到 SecurityException, 参 与 类 顶部 的 广 解 
Log.WriteEntry(message, type, (int)eventID, (short)category); 
} 


public void WriteToLog(string message, EventLogEntryType type, 
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} 


CategoryType category, EventIDType eventID, byte[] rawData) 


if (Log == null) 
throw (new ArgumentNullException(nameof(Log), 
"This Event Log has not been opened or has been closed.")); 


EventLogPermission evtPermission = 
new EventLogPermission(EventLogPermissionAccess.Write, MachineName); 
evtPermission.Demand(); 


// 如 果 此 处 遇 到 SecurityException, 参 见 类 顶部 的 注解 
Log.WriteEntry(message, type, (int)eventID, (short)category, rawData); 





public IEnumerable<EventLogEntry> GetEntries() 


{ 


} 


EventLogPermission evtPermission = 


new EventLogPermission(EventLogPermissionAccess.Administer, MachineName) ; 


evtPermission.Demand(); 
return Log?.Entries.Cast<EventLogEntry>().Where(evt => 
evt.Source == SourceName); 


public void ClearLog() 


{ 


} 


EventLogPermission evtPermission = 


new EventLogPermission(EventLogPermissionAccess.Administer, MachineName) ; 


evtPermission.Demand(); 
if (!IsNonCustomLog()) 
Log?.Clear(); 


public void CloseLog() 


{ 


} 


Log?.Close(); 
Log = null; 


public void DeleteLog() 


t 


} 


if (!IsNonCustomLog()) 
if (EventLog.Exists(LogName, MachineName) ) 
EventLog.Delete(LogName, MachineName); 
CloseLog(); 


public bool IsNonCustomLog( ) 


{ 

















// (KAApplication, Setup, Security, System 和 其 他 非 用 户 定义 的 日 志 
// 包含 关键 信息 ,所 以 不 能 删除 或 清空 它们 
if (LogName == string.Empty || // 与 Application 相 同 














LogName == "Application" | | 
LogName == "Security" || 
LogName == "Setup" || 
LogName == "System") 
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return true; 
return false; 
j 
该 类 中 使 用 的 EventIDType 和 CategoryType 枚 举 定义 如 下 所 示 。 


public enum EventIDType 
{ 





NA = 0, 

Read = 1, 

Write = 2, 

ExceptionThrown = 3, 
BufferOverflowCondition = 4, 
SecurityFailure = 5, 
SecurityPotentiallyCompromised = 6 


} 


public enum CategoryType : short 

{ 
None = 0, 
WriteToDB = 1, 
ReadFromDB = 2, 
WriteToFile = 3, 
ReadFromFile = 4, 
AppStartUp = 5, 
AppShutDown = 6, 
UserInput = 7 

} 


最 后 要 说 明 的 一 点 是 ，EventIDType 和 CategoryType 枚 举 主 要 设计 用 于 记录 违反 安全 的 事 
件 以 及 对 应 用 程序 安全 的 法 在 攻击 。 使 用 这 些 事件 ID 和 类 别 ， 管 理 员 可 以 更 轻松 地 跟踪 
潜在 的 安全 威胁 ， 并 在 发 生 违 反 安全 的 事件 后 进行 事后 分 析 。 你 可 以 轻松 地 修改 这 些 枚 举 
或 者 用 自己 的 枚 举 禁 换 它 们 ， 以 便 跟踪 在 应 用 程序 运行 时 发 生 的 不 同事 件 。 


5.10.3 讨论 
为 本 范例 创建 的 AppEvents 类 给 应 用 程序 提供 了 易于 使 用 的 接口 ， 用 于 在 应 用 程序 中 创建 、 
使 用 和 删除 一 个 或 多 个 事件 日 志 。 下 面 描述 了 AppEvents 类 的 方法 。 
e WriteToLog 
3E CIA TTS PCVE EAA FH — 7 8158 Ir HY BLS BS BSE H RE 
。 GetEntries 
返回 一 个 包含 事件 源 中 所 有 事 
e ClearLog 
如 果 是 一 个 自 定义 日 志 ， 从 该 事件 日 志 中 删除 所 有 事件 日 志 条 目 。 






































pun 
> 





日 志 条 目的 IEnumerable«EventLogEntry», 








e CloseLog 
关闭 该 事件 日 志 ， 防 止 与 它 的 进一步 交互 。 
e DeleteLog 


如 果 是 一 个 自 定义 日 志 ， 删 除 该 事件 日 志 。 


可 以 把 一 个 AppEvents 对 象 添 加 到 包含 其 他 AppEvents 对 象 的 数组 或 集合 中 ， 每 个 
AppEvents 对 象 都 对 应 一 个 特定 的 事件 日 志 。 下 面 的 代码 创建 了 两 个 AppEvents 类 ， 并 将 它 
们 添加 到 ListDictionary 集合 中 。 























public void CreateMultipleLogs() 
{ 
AppEvents AppEventLog = new AppEvents("AppLog", "AppLocal"); 
AppEvents GlobalEventLog = new AppEvents("AppSystemLog", "AppGlobal"); 


ListDictionary LogList = new ListDictionary(); 
LogList.Add(AppEventLog.Name, AppEventLog); 
LogList.Add(GlobalEventLog.Name, GlobalEventLog) ; 


为 了 写 到 其 中 任何 一 个 日 志 中 ， 可 以 按 名 称 从 ListDictionary 对 象 中 获取 AppEvents 对 象 ， 
把 得 到 的 对 象 类 型 转换 成 AppEvents 类 型 ， 并 且 调 用 WriteToLog 方法 。 
((AppEvents )LogList[AppEventLog.Name]).WriteToLog("App startup", 


EventLogEntryType. Information, CategoryType.AppStartUp, 
EventIDType.ExceptionThrown); 





((AppEvents )LogList[GlobalEventLog.Name]).WriteToLog( 
"App startup security check", 
EventLogEntryType.Information, CategoryType.AppStartUp, 
EventIDType.BufferOverflowCondition); 


通过 在 ListDictionary 对 象 中 包含 所 有 AppEvents 对 象 ， 可 以 轻松 地 遍历 应 用 程序 已 
例 化 的 所 有 AppEvents。 使 用 foreach 循环 ， te ae 
志 中 。 


foreach (DictionaryEntry Log in LogList) 





{ 

((AppEvents)Log.Value).WriteToLog("App startup", 
EventLogEntryType.FailureAudit, 
CategoryType.AppStartUp, EventIDType.SecurityFailure); 

} 


要 删除 LogList 对 象 中 的 每 个 日 志 ， 可 以 使 用 下 面 的 foreach 循环 。 


foreach (DictionaryEntry Log in LogList) 


{ 
((AppEvents )Log.Value) .DeleteLog(); 


LogList.Clear(); 


你 需要 知道 儿 个 关键 的 要 点 。 第 一 个 涉及 关于 构造 多 个 AppEvents 类 的 一 个 小 问题 。 如 果 创 
建 两 个 AppEvents 对 象 ， 并 且 把 相同 的 source 字符 串 传 入 AppEvents 构造 函数 中 ， 将 会 引发 
一 个 异常 。 芳 虑 下 面 的 代码 ， 它 利用 相同 的 source 字符 串 实例 化 两 个 AppEvents 对 象 。 
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AppEvents appEventLog = new AppEvents("AppLog", "AppLocal"); 
AppEvents globalEventLog = new AppEvents("Application", "AppLocal"); 


在 实例 化 对 象 时 没有 发 生 错误 ， 但 是 当 对 globalEventLog 对 象 调用 WriteToLog 方法 时 ， 将 
会 引发 下 面 的 异常 。 
An unhandled exception of type 'System.ArgumentException' occurred in system.dll. 


Additional information: The source 'AppLocal' is not registered in log 
'Application'. (It is registered in log 'AppLog'.) " The Source and Log 
properties must be matched, or you may set Log to the empty string, and 
it will automatically be matched to the Source property. 


之 所 以 会 发 生 这 个 异常 ， 是 因为 WriteToLog 方法 在 内 部 调用 EventLog 对 象 的 writeEntry 
方法 。WriteEntry 方法 在 内 部 检查 指定 的 源 是 否 被 注册 到 你 尝试 写 的 日 志 。 年 这 种 情况 
下 ，AppLog 源 被 注册 到 分 配给 它 的 第 一 个 日 志 ， 即 AppLog 日 志 。 如 果 第 二 次 尝试 把 这 个 
相同 的 源 注册 到 另 一 个 日 志 ， 即 人 日 志 ， 则 会 悄然 失败 。 在 尝试 使 用 EventLog 
对 象 的 WriteEntry 方法 之 前 ， 不 会 知道 这 次 尝试 已 经 失败 。 


关于 AppEvents 类 的 另 一 个 关键 点 是 如 下 代码 ， 它 位 于 每 个 方法 (DeleteLog 方法 除外 ) 的 
开始 处 。 
if (log == null) 


throw (new ArgumentNullException("log", 
"This Event Log has not been opened or has been closed.")) 


这 段 代 码 检 查 私 有 成 员 变量 Log 是 否 是 一 个 nuLtL 引 用 。 如 果 是 ， 就 会 引发 一 个 
ArgumentException， 通 知 该 类 的 用 户 在 创建 EventLog 对 象 时 发 生 了 一 个 问题 。DeleteLog 
方法 不 会 检查 变量 log 是 否 为 null， 因 为 它 会 删除 事件 日 志 源 和 事件 日 志 本 身 。 除 了 在 该 
方法 的 末尾 外 ， 在 这 个 过 程 中 不 会 涉及 EventLog 对 象 ， 其 中 如 果 log 还 不 是 null 的 话 ， 
它 会 被 关闭 并 被 设置 为 nutl。 不 管 变量 log 的 状态 是 什么 ， 都 应 该 在 此 方法 中 删除 源 和 事 
件 日 志 。 


ClearLog 和 DeleteLog 方法 在 确定 是 否 删 除 日 志 时 会 作出 一 个 关键 的 选择 。 下 面 的 代码 会 
阻止 从 系统 中 删除 应 用 程序 、 安 全 和 系统 事件 日 志 。 


public bool IsNonCustomLog() 


















































{ 
// 因为 Application、Setup、Security、System 和 其 他 非 用 户 定义 的 日 志 
// 包含 关键 信息 ,所 以 不 能 删除 或 清空 它们 
if (LogName == string.Empty || // 与 Application 相 同 
LogName == "Application" || 
LogName == "Security" || 
LogName == "Setup" || 
LogName == "System") 
{ 
return true; 
} 
return false; 
} 


如 果 删 除了 其 中 的 任何 日 志 ， 也 会 删除 使 用 该 特定 日 志 注 册 的 源 。 一 旦 删除 了 日 志 ， 就 会 
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永久 删除 ， 相 信 我 们 ， 在 没有 备份 的 情况 下 尝试 重建 日 志 及 其 源 并 不 是 一 件 有 趣 的 事情 。 
尽管 如 此 ， 为 了 使 AppEvents 类 工作 ， 首 先 需要 创建 事件 源 。 事 件 日 志 使 用 事件 源 来 确定 
E E 仅 在 管理 上 下 文中 运行 时 ， 才 可 以 建立 事件 源 。 有 下 面 两 种 








方法 可 以 做 到 这 一 点 。 


。 调用 EventLog.CreateEventSource 方法 。 
。 使 用 一 个 EventLogInstaller, 


虽然 可 以 创建 一 个 控制 台 应 用 程序 ， 调 用 CreateEventSource 方法 ， 并 让 一 个 用 户 在 其 机 


器 的 管理 上 下 文中 运行， 但 推荐 的 选项 是 建立 一 个 EventLogInstaller 类 ， 

















InstallUtil.exe (由 .NET Framework 提供 ) ， 以 创建 初始 的 事件 源 和 自 定 义 日 志 。 
下 面 展示 的 AppEventsEventLogInstaller 将 为 我 们 建立 事件 日 志和 源 。 此 安装 程序 不 仅 可 














以 由 InstallUtil 调用 ， 
































它 可 以 用 于 


还 可 以 由 大 多 数 安装 包 调 用 。 因 此 ， 可 以 将 其 加 入 你 喜爱 的 安装 软 


件 ， 只 要 用 户 具 有 管理 访问 权限 〈 或 至 少 有 拥有 相应 权限 的 IT 专业 人 员 帮 助 )， 就 能 在 安 
装 时 注册 事件 日 志和 源 。 


/// <summary> 


/// 安装 : 


C:\Windows\Microsoft.NET\Framework\v4.0.30319\InstallUtil.exe 


/// [PathToBinary]\AppEventsEventLogInstallerApp.dll 

/// dX: C:\Windows\Microsoft.NET\Framework\v4.0.30319\InstallUtil.exe -u 
/// [PathToBinary]\AppEventsEventLogInstallerApp.dlL 

/// </summary> 

[RunInstaller(true) ] 

public class AppEventsEventLogInstaller : Installer 


private EventLogInstaller evtLogInstaller; 


public AppEventsEventLogInstaller() 


evtLogInstaller - new EventLogInstaller(); 
evtLogInstaller.Source = "APPEVENTSSOURCE" ; 
evtLogInstaller.Log = ""; // 默认 为 Application 
Installers.Add(evtLogInstaller); 


evtLogInstaller - new EventLogInstaller(); 
evtLogInstaller.Source = "AppLocal"; 
evtLogInstaller.Log = "AppLog"; 
Installers.Add(evtLogInstaller); 


evtLogInstaller - new EventLogInstaller(); 
evtLogInstaller.Source = "AppGlobal"; 
evtLogInstaller.Log = "AppSystemLog"; 
Installers.Add(evtLogInstaller); 


public static void Main() 


( 
{ 
} 
{ 
} 
} 


AppEventsEventLogInstaller appEventsEventLogInstaller = 
new AppEventsEventLogInstaller(); 
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如 果 你 使 用 Installutil 在 本 机 如 此 设置 ， 当 使 用 适当 的 管理 上 下 文 (“Run As Administrator” ) 
时 ， 可 能 会 看 到 如 下 输出 。 








C: \Windows\Microsoft.NET\Framework\v4.0.30319\InstallLUtil.exe 
C:\CSCB6\AppEventsEventLogInstallerApp\bin\Debug\ 
AppEventsEventLogInstallerApp.dll 


C:\WINDOWS\system32>C: \Windows\Microsoft.NET\Framework\v4.0.30319\InstallUtil.exe 
C: \CSCB6\AppEventsEventLogInstallerApp\bin\Debug\ 
AppEventsEventLogInstallerApp.dll 

Microsoft (R) .NET Framework Installation utility Version 4.0.30319.33440 
Copyright (C) Microsoft Corporation. ALL rights reserved. 


Running a transacted installation. 


Beginning the Install phase of the installation. 

See the contents of the log file for the 
C:\CSCB6\AppEventsEventLogInstallerApp\bin\Debug\ 
AppEventsEventLogInstallerApp.dll 

assembly's progress. 

The file is located at C:\CSCB6\AppEventsEventLogInstallerApp\bin\Debug\ 


AppEventsEventLogInstallerApp.InstallLlog. 
Installing assembly 'C:\CSCB6\AppEventsEventLogInstallerApp\bin\Debug\ 
AppEventsEventLogInstallerApp.dll'. 
Affected parameters are: 

logtoconsole - 

logfile = C:\CSCB6\AppEventsEventLogInstallerApp\bin\Debug\ 
AppEventsEventLogInstallerApp. InstallLog 

assemblypath = 
C:\CSCB6\AppEventsEventLogInstallerApp\bin\Debug\ 
AppEventsEventLogInstallerApp.dll 
Creating EventLog source APPEVENTSSOURCE in log ... 
Creating EventLog source AppLocal in log AppLog... 
Creating EventLog source AppGlobal in log AppSystemLog... 


The Install phase completed successfully, and the Commit phase is beginning. 
See the contents of the log file for the 
C:\CSCB6\AppEventsEventLogInstallerApp\bin\Debug\ 
AppEventsEventLogInstallerApp.dll 
assembly's progress. 
The file is located at C:\CSCB6\AppEventsEventLogInstallerApp\bin\Debug\ 
AppEventsEventLogInstallerApp. InstallLog. 
Committing assembly 
'C:\CSCB6\AppEventsEventLogInstallerApp\bin\Debug\ 
AppEventsEventLogInstallerApp.dll'. 
Affected parameters are: 

logtoconsole - 

logfile = C:\CSCB6\AppEventsEventLogInstallerApp\bin\Debug\ 
AppEventsEventLogInstallerApp.InstallLog 

assemblypath = 
C:\CSCB6\AppEventsEventLogInstallerApp\bin\Debug\ 
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AppEventsEventLogInstallerApp.dll 
The Commit phase completed successfully. 


The transacted install has completed. 


如 有 果 试 图 在 非 管理 上 下 文中 运行 InstaLLUtiL， 将 会 看 到 如 下 的 结果 。 


C:\Windows\Microsoft.NET\Framework\v4.0.30319\InstallUtil.exe 
C:\CSCB6\AppEventsEventLogInstallerApp\bin\Debug\ 
AppEventsEventLogInstallerApp.dll 

Microsoft (R) .NET Framework Installation utility Version 4.0.30319.33440 
Copyright (C) Microsoft Corporation. ALL rights reserved. 





Running a transacted installation. 


Beginning the Install phase of the installation. 

See the contents of the log file for the 
C:\CSCB6\AppEventsEventLogInstallerApp\bin\Debug\AppEventsEventLogInstallerApp.dll 
assembly's progress. 

The file is located at C:\CSCB6\AppEventsEventLogInstallerApp\bin\Debug\ 


AppEventsEventLogInstallerApp. InstallLog. 
Installing assembly 
'C:\CSCB6\AppEventsEventLogInstallerApp\bin\Debug\ 
AppEventsEventLogInstallerApp.dll'. 
Affected parameters are: 

logtoconsole - 

logfile = C:\CSCB6\AppEventsEventLogInstallerApp\bin\Debug\ 
AppEventsEventLogInstallerApp.InstallLlog 

assemblypath - 
C:\CSCB6\AppEventsEventLogInstallerApp\bin\Debug\ 
AppEventsEventLogInstallerApp.dll 
Creating EventLog source APPEVENTSSOURCE in log APPEVENTSLOG... 


An exception occurred during the Install phase. 
System.Security.SecurityException: The source was not found, but some or all 
event logs could not be searched. Inaccessible logs: Security. 


The Rollback phase of the installation is beginning. 
See the contents of the log file for the 
C:\CSCB6\AppEventsEventLogInstallerApp\bin\Debug\ 
AppEventsEventLogInstallerApp.dll 
assembly's progress. 
The file is located at C:\CSCB6\AppEventsEventLogInstallerApp\bin\Debug\ 
AppEventsEventLogInstallerApp.InstallLlog. 
Rolling back assembly 
'C:\CSCB6\AppEventsEventLogInstallerApp\bin\Debug\ 
AppEventsEventLogInstallerApp.dll'. 
Affected parameters are: 

logtoconsole - 

logfile = C:\CSCB6\AppEventsEventLogInstallerApp\bin\Debug\ 
AppEventsEventLogInstallerApp.InstallLlog 

assemblypath = 
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C:\CSCB6\AppEventsEventLogInstallerApp\bin\Debug\ 
AppEventsEventLogInstallerApp.dll 

Restoring event log to previous state for source APPEVENTSSOURCE. 

An exception occurred during the Rollback phase of the 
System.Diagnostics.EventLogInstaller installer. 
System.Security.SecurityException: Requested registry access is not allowed. 

An exception occurred during the Rollback phase of the installation. This except 
ion will be ignored and the rollback will continue. However, the machine might n 
ot fully revert to its initial state after the rollback is complete. 


The Rollback phase completed successfully. 


The transacted install has completed. 
The installation failed, and the rollback has been performed. 


Installutil 不 仅 可 以 安装 事件 日 志和 源 ， 还 可 以 使 用 -u 参数 帮助 移 除 它们 。 


C:\Windows\Microsoft.NET\Framework\v4.0.30319\InstallUtil.exe -u 
C:\CSCB6\AppEventsEventLogInstallerApp\bin\Debug\ 
AppEventsEventLogInstallerApp.dll 


Microsoft (R) .NET Framework Installation utility Version 4.0.30319.33440 
Copyright (C) Microsoft Corporation. ALL rights reserved. 


The uninstall is beginning. 
See the contents of the log file for the 
C:\CSCB6\AppEventsEventLogInstallerApp\bin\Debug\ 
AppEventsEventLogInstallerApp.dll 
assembly's progress. 
The file is located at C:\CSCB6\AppEventsEventLogInstallerApp\bin\Debug\ 
AppEventsEventLogInstallerApp.InstallLog. 
Uninstalling assembly 
'C:\CSCB6\AppEventsEventLogInstallerApp\bin\Debug\ 
AppEventsEventLogInstallerApp.dll'. 
Affected parameters are: 
logtoconsole - 
logfile = C:\CSCB6\AppEventsEventLogInstallerApp\bin\Debug\ 
AppEventsEventLogInstallerApp. InstallLog 
assemblypath = 
C:\CSCB6\AppEventsEventLogInstallerApp\bin\Debug\ 
AppEventsEventLogInstallerApp.dll 
Removing EventLog source AppGlobal. 
Deleting event log AppSystemLog. 
Removing EventLog source AppLocal. 
Deleting event log AppLog. 
Removing EventLog source APPEVENTSSOURCE. 


The uninstall has completed. 








应 该 把 从 应 用 程序 写 到 事件 日 志 中 的 条 目 数量 减 至 最 少 ， 因 为 写 到 事件 日 志 
中 会 导致 性 能 损失 ， 并 且 设 有 将 某 些 日 志 设置 为 达到 一 定数 量 的 条 目 后 滚动 
或 清除 。 向 事件 日 志 写 入 太 多 信息 可 能 会 显著 减 慢 应 用 程序 或 者 导致 服务 器 
问题 。 明 智 地 选择 写 到 事件 日 志 的 条 目 。 
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5.10.4 参考 


MSDN 文档 中 的 “EventLog 2” “InstallUtil.exe” fH “EventLogInstaller 类 ”主题 。 





5.11 监视 事件 日 志 中 的 特定 条 目 


5.11.1 问题 





你 可 能 有 多 个 应 用 程序 写 到 一 个 事件 日 志 。 对 于 其 中 每 个 应 用 程序 ， 你 想 使 用 一 个 监控 应 




















5.11.2 ”解决 方案 


监视 事件 日 志 中 的 特定 条 目 需要 执行 以 下 步骤 。 
































(1) 创建 以 下 方法 来 建立 事件 处 理 程序 ， 以 处 理事 件 日 志 写 操作 : 
public void WatchForAppEvent(EventLog log) 
{ 
log.EnableRaisingEvents = true; 
// 挂 接 System.Diagnostics.EntryWrittenEventHandler 
log.EntryWritten += new EntryWrittenEventHandler(OnEntryWritten); 
} 
(2) 创建 事件 处 理 程 序 检查 日 志 条 目 ， 并 确定 是 否 执行 进一步 的 动作 。 例 如 : 





public static void OnEntryWritten(object source, 
EntryWrittenEventArgs entryArg) 


{ 
if (entryArg.Entry.EntryType == EventLogEntryType.Error) 
t 
Console.WriteLine(entryArg.Entry.Message); 
Console.WriteLine(entryArg.Entry.Category); 
Console.WriteLine(entryArg.Entry.EntryType.ToString()); 
// 需要 时 执行 进一步 的 动作 
} 
} 


5.11.3 讨论 


用 程序 来 监视 写 到 事件 日 志 中 的 一 个 或 多 个 特定 的 日 志 条 目 。 例 如 ， 你 可 能 想 监 
志 条 目 ， 它 指示 应 用 程序 遇 到 关键 错误 或 者 意外 关闭 。 应 该 实时 报告 这 些 日 志 条 目 。 


视 一 个 日 


本 范例 涉及 EntryWrittenEventHandler 委托 ， 无 论 何 时 把 一 个 新 条 目 写 到 事件 日 志 中 ， 它 
都 会 回调 一 个 方法 。EntrywrittenEventHandler 委托 接受 两 个 参数 : object 类 型 的 source 
和 EntryWrittenEventArgs 类 型 的 entryArg, entryArg 参数 是 这 两 个 参数 中 更 有 趣 的 参数 。 
它 包含 一 个 名 为 Entry 的 属性 ， 该 属性 返回 一 个 EventLogEntry 对 象 。 这 个 EventLogEntry 











对 象 包含 所 有 你 需要 的 关于 写 到 事件 日 志 的 条 目的 信息 。 





将 你 正在 监视 的 这 个 事件 日 志 作为 watchForAppEvent 方法 的 参数 进行 传递 。 该 方法 执行 




















个 操作 。 首 先 ， 它 将 log 的 EnableRaisingEvents 属性 设置 为 true。 如 果 把 该 属性 设置 为 
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false， 那 么 在 把 条 目 写 到 这 个 事件 日 志 中 时 将 不 会 为 它 引发 任何 事件 。 该 方法 执行 的 第 二 
个 操作 是 把 OnEntryWritten 回调 方法 添加 到 这 个 事件 日 志 的 事件 处 理 程序 的 列表 中 。 

为 了 阻止 该 委托 调用 onEntryWritten 回调 方法 ， 可 以 把 EnableRaisingEvents 属性 设置 为 
false， 从 而 有 效 地 关闭 委托 。 
注意 传递 给 OnEntryWritten 回调 方法 的 entryArg 参数 的 Entry 对 象 是 只 读 的 ， 因 此 在 把 条 
目 写 到 事件 日 志 中 之 前 不 能 修改 它 。 





























5.11.4 ”参考 
MSDN 文档 中 的 “EventLog.EntryWritten 事件 ”主题 。 


5.12 ”实现 一 个 简单 的 性 能 计数 器 


5.12.1 问题 


你 需要 使 用 一 个 性 能 计数 器 来 跟踪 特定 于 应 用 程序 的 信息 。 例 如 ， 较 为 简单 的 性 能 计数 器 
可 以 找 出 连续 取样 之 间 的 计数 器 值 中 的 变化 ， 或 者 只 是 统计 某 种 动作 发 生 的 次 数 。 还 有 其 
他 更 复杂 的 计数 器 ， 但 是 本 范例 中 没有 涉及 它们 。 例 如 ， 可 以 构建 一 个 自 定义 计数 器 ， 用 
于 记录 数据 库 事务 的 数量 、 连 接 到 服务 器 的 网 络 连接 失败 的 次 数 ， 甚 至 记录 每 分 钟 连接 到 
你 的 Web 服务 的 用 户 数 。 


5.12.2 ”解决 方案 


创建 一 个 简单 的 性 能 计数 器 ， 例 如 找 出 连续 取样 之 间 的 计数 器 值 中 的 变化 或 者 只 是 统计 某 
种 动作 发 生 的 次 数 。 使 用 下 面 的 方法 (CreateSimpleCounter) 创建 一 个 简单 的 自 定 义 计 
数 器 。 

public static PerformanceCounter CreateSimpleCounter(string counterName, 


string counterHelp, PerformanceCounterType counterType, string categoryName, 
string categoryHelp) 









































CounterCreationDataCollection counterCollection = 
new CounterCreationDataCollection(); 


// 创建 一 个 自 定义 计数 器 对 象 并 将 其 添加 到 计数 器 集合 中 
CounterCreationData counter = 

new CounterCreationData(counterName, counterHelp, counterType); 
counterCollection.Add(counter); 








// 创建 类 别 
if (PerformanceCounterCategory.Exists(categoryName) ) 
PerformanceCounterCategory.Delete(categoryName); 


PerformanceCounterCategory appCategory - 
PerformanceCounterCategory.Create(categoryName, categoryHelp, 
PerformanceCounterCategoryType.SingleInstance, counterCollection); 
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// 创建 计数 器 并 将 其 初始 化 
PerformanceCounter appCounter = 
new PerformanceCounter(categoryName, counterName, false); 


appCounter.RawValue = 0; 


return (appCounter); 


5.12.3 讨论 


该 方法 执行 的 第 一 个 操作 是 创建 CounterCreationDataCollection 对 象 和 CounterCreationData 对 
象 。 使 用 传递 给 CreateSimpleCounter 方法 的 counterName, counterHelp 和 countertype 参数 创 
建 CounterCreationData 对 象 。 然 后 把 该 CounterCreationData 对 象 添 加 到 counterCollection 中 。 











默认 情况 下 ，ASPNET 用 户 账号 以 及 许多 其 他 用 户 账号 会 因 安全 原因 阻止 读 取 
性 能 计数 器 。 你 可 以 提升 这 些 账 户 的 权限 ， 也 可 以 模拟 具有 访问 权限 的 账户 
来 启用 该 功能 。 不 过 ， 这 在 以 后 将 变 成 应 用 程序 的 一 项 部 署 要 求 。 

这 样 做 也 存在 风险 ， 因 为 作为 开发 人 员 ， 你 是 安全 事项 的 第 一 道 防线 。 如 果 
你 建立 应 用 ， 并 作出 放松 安全 限制 的 选择 ， 那 么 将 承担 这 一 责任 ， 所 以 请 不 
要 不 加 选择 地 或 者 在 没有 充分 理解 后 果 的 情况 下 就 这 样 做 。 
































如 果 系 统 上 没有 注册 categoryName ( 它 是 一 个 包含 类 别名 称 的 字符 串 ， 作 为 参数 传 到 
个 方法 )， 就 会 用 PerfomanceCounterCategory 对 象 创 建 一 个 新 类 别 。 如 果 类 别 被 注册 
过 了 ， 就 会 删除 它 并 重新 创建 一 个 。 最 后 ， 从 PerfomanceCounter 对 象 创建 实际 的 性 
能 计数 器 。 该 对 象 被 初始 化 为 6 并 由 方法 返回 。PerfomanceCounterCategory 获取 一 个 
PerfomanceCounterCategoryType 作为 参数 。 可 能 的 设置 如 表 5-1 所 示 。 


表 5-1: PerformanceCounterCategoryType 枚 举 值 




















名 称 描 述 

MultiInstance 性 能 计数 器 可 以 有 多 个 实例 
SingleInstance 性 能 计数 器 只 能 有 一 个 实例 
Unknown 该 性 能 计数 器 的 实例 功能 是 未 知 的 





CreateSimpleCounter 方法 返回 一 个 将 由 应 用 程序 使 用 的 PerformanceCounter 对 象 。 应 用 程 
序 可 以 在 PerformanceCounter 对 象 上 执行 多 种 操作 。 应 用 程序 可 以 使 用 以 下 三 种 方法 之 一 
递增 或 递减 它 。 

long value = appCounter.Increment(); 

long value = appCounter.Decrement(); 

long value = appCounter.IncrementBy(i); 

// 此 外 ,可 以 把 一 个 负数 传递 到 

// IncrementBy 方 法 以 模拟 DecrementBy 方 法 

// (此 方法 并 未 包含 在 此 类 中 ) 
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il 





il 


// 例如 : 

long value = appCounter.IncrementBy(-i); 
1 两 个 方法 不 接受 任何 参数 ， 而 第 三 个 方法 接受 一 个 lon 类 型 的 参数 ， 其 中 包含 用 于 递增 
| 数 器 的 数字 。 这 三 个 方法 都 返回 一 个 Long 类 型 ， 指 示 计 数 器 的 新 值 。 














除了 递增 或 递减 计数 器 之 外 ， 还 可 以 获取 计数 器 在 应 用 程序 中 多 个 时 间 点 的 样本 。 样 本 是 





| 数 器 及 其 所 有 值 在 特定 时 刻 的 快照 。 可 以 使 用 下 面 一 行 代码 获取 样本 。 


CounterSample counterSampleValue = appCounter.NextSample(); 














NextSample 方法 不 接受 任何 参数 ， 并 且 返 回 一 个 CounterSample 结构 。 


在 应 用 程序 中 的 另 一 个 时 间 点 ， 可 以 再 次 对 计数 器 取样 ， 并 且 可 以 把 两 个 样本 传递 给 
CounterSample 类 的 静态 方法 Calculate。 可 以 利用 单独 一 行 代码 执行 此 操作 ， 如 下 所 示 。 

















float calculatedSample = CounterSample.Calculate(counterSampleValue, 
appCounter .NextSample()); 


可 以 对 计算 得 到 的 样本 calculatedSample 进行 存储 ， 以 便 将 来 分 析 。 
.NET Framework 中 已 经 提供 的 简单 性 能 计数 器 包括 以 下 这 些 。 

















CounterDelta32/CounterDelta64 

确定 计数 器 的 两 次 取样 之 间 值 的 区 别 (或 变化 )。CounterDelta64 计数 器 可 以 保存 比 
CounterDelta32 更 大 的 值 。 

CounterTimer 

计算 Counter Timer 值 随 着 CounterTimer 时 间 的 改变 而 发 生 的 改变 的 百分比 。 以 总 采样 
时 间 的 百分比 跟踪 资源 的 平均 活跃 时 间 。 

CounterTimerInverse 

计算 counterTimer 计数 器 的 倒数 。 以 总 采样 时 间 的 百分比 跟踪 资源 的 平均 非 活 跃 时 间 。 
CountPerTimeInterval32/CountPerTimeInterval64 

计算 一 段 时 间 内 队列 中 等 待 资源 的 项 目 数 。 这 些 计 数 器 会 给 出 按 间隔 持续 时 间 划 分 的 最 
后 两 个 样本 间隔 内 的 队列 长 度 增 量 。 

ElapsedTime 

计算 计数 器 记录 的 事件 开始 时 间 与 当前 时 间 之 差 ， 以 秒 为 单位 。 
NumberOfItems32/NumberOfItems64 

这 些 计 数 嚣 以 十 进 制 格 式 返 回 它们 的 值 。NumberofItems64 计数 器 可 以 保存 比 
NumberofItems32 更 大 的 值 。 该 计数 器 不 需要 传递 给 CounterSample 类 的 静态 方法 
Calculate; 没有 需要 计算 的 值 。 使 用 PerformanceCounter 对 象 的 RawValue 属性 来 代替 
(也 就 是 说 ， 在 本 范例 中 将 使 用 appCounter .RawValue 属性 ) 。 
RateOfCountsPerSecond32/RateOfCountsPerSecond64 


计算 RateOfCountsPerSecond* 值 随 着 RateOfCountsPerSecond* 时 间 的 改变 而 发 生 的 改变 ， 
以 秒 为 单位 。Rate0fCountsPerSecond64 计数 器 可 以 保存 比 RateOfCountsPerSecond32 计数 
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器 更 大 的 值 。 

e Timer100Ns 
将 活动 组 件 的 时 间 显示 为 样本 间隔 的 总 消耗 时 间 的 百分比 ， 以 100 纳 秒 (ns) 为 单位 。 
这 类 计数 器 的 一 个 例子 是 “Processor\ % User Time", 

e TimeriO0OnsInverse 
一 个 基于 百分比 的 计数 器 ， 显 示 在 样本 时 间 间 隔 期 间 跟 踪 的 平均 话 动 时 间 的 百分比 。 这 
类 计数 器 的 一 个 例子 是 “Processor\ % Processor Time" , 








5.12.4 参考 


MSDN 文档 中 的 “PerformanceCounter 类 ”“PerformanceCounterType 枚 举 ”“pPerforman- 
” “ASP.NET Impersonation” 和 “Monitoring Performance Thresholds” 





ceCounterCategory 类 
主题 。 


5.13 为 类 创建 自 定义 的 调试 显示 


5.13.1 问题 


你 在 应 用 程序 中 使 用 了 一 组 类 。 你 想 在 调试 器 中 快速 查看 类 中 保存 的 特定 实例 。 默 认 的 调 
试 器 显示 不 会 展示 自 定 义 类 的 任何 有 用 信息 。 


5.13.2 ”解决 方案 


癌 类 添加 一 个 DebuggerDisplayAttribute， 使 调试 器 显示 你 认为 有 用 的 此 类 相关 信 
息 。 例 如 ， 如 果 有 一 个 保存 尊称 和 姓名 的 Citizen 类 ， 就 可 以 像 下 面 这 样 添加 一 个 


DebuggerDisplayAttribute, 

















[DebuggerDisplay("Citizen Full Name = {Honorific}{First}{Middle}{Last}")] 
public class Citizen 


{ 
public string Honorific { get; set; } 
public string First { get; set; } 
public string Middle { get; set; } 
public string Last { get; set; } 

} 


现在 ， 当 实例 化 Citizen 类 的 实例 上 时， 调试 器 将 按 此 类 的 DebuggerDisplayAttribute 指导 
它 的 方式 显示 信息 。 为 了 查看 此 行为 ， 可 实例 化 两 个 Citizen (Mrs. Alice G. Jones 和 Mr. 
Robert Frederick Jones)， 如 下 所 示 。 


Citizen mrsJones = new Citizen() 
{ 

Honorific = "Mrs.", 

First = "Alice", 

Middle = "G.", 

Last = "Jones" 
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Citizen mrJones - new Citizen() 


{ 
Honorific = "Mr.", 
First = "Robert", 
Middle = "Frederick", 
Last = "Jones" 

J; 


在 调试 器 下 运行 这 段 代 码 时 ， 就 会 使 用 自 定义 的 显示 ， 如 图 5-9 所 示 。 








Name Value Type 
b @ mrsjones Citizen Full Name = "Mrs.""Alice""G.""Jones" CSharpR 
b € mrones Citizen Full Name = "Mr.""Robert""Frederick""Jones" CSharpR 











图 5-9: DebuggerDisplayAttribute 控制 的 调试 器 显示 


5.13.3 iit 


能 够 迅速 查看 你 编写 的 类 的 相关 信息 当然 很 好 ， 但 是 这 种 特性 的 更 强大 的 功能 在 于 它 能 够 
让 你 的 团队 成 员 迅 速 了 解 类 实例 保存 的 是 什么 。 可 以 从 DebuggerDisplayAttribute 声明 访 
问 this 指针 ， 但 是 使 用 this 指针 访问 的 任何 属性 在 处 理 前 都 不 会 对 属性 的 特性 进行 求 值 。 
实质 上 ， 如 果 访 问 作为 构造 显示 字符 串 的 一 部 分 的 当前 对 象 实例 的 属性 ， 并 且 该 属性 具有 
特性 ， 则 不 会 处 理 这 些 特性 ， 因 此 也 许 没 有 获取 到 预想 中 的 值 。 如 果 你 已 经 具有 自 定义 的 
ToString() 重 写 版 本 ,调试 器 将 把 它们 用 作 DebuggerDisplayAttribute, 无 需 指 定 它们 ， 
只 要 在 Tools\Options\Debugging 下 启用 了 正确 的 选项 即 可 ， 如 图 5-10 所 示 。 


Options ? 































































































Search Options (Ctrl+E) P General 
b Environment ^ V| Enable the exception assistant ^ 
b Projects and Solutions V| Unwind the call stack on unhandled exceptions 
b Source Control v| Enable Just My Code 
b Text Editor Show all members for non-user objects in variables windows (Visual Bas 
4 Debugging v| Warn if no user code on launch (Managed only) 
General Enable .NET Framework source stepping 
Edit and Continue | Step over properties and operators (Managed only) 
Just-In-Time V| Enable property evaluation and other implicit function calls 
Output Window z 
Ee Enable source server support 









































uem Print source server diagnostic messages to the Output window 
: garni Allow source server for partial trust assemblies (Managed only) 
EDS Too Always run untrusted source server commands without prompting 
b. Ff Tools Highlight entire source line for breakpoints and current statement (C++ onh 
b Graphics Diagnostics d Reouire source files to exactly match the nrininal version 5 4 
b HTML Designer v 
OK Cancel 




















5-10; 将 调试 器 设置 为 调用 TostringO 以 进行 对 象 显示 
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5.13.4 B84 


MSDN 文档 中 的 “使 用 DebuggerDisplay 特性 ”和 “DebuggerDisplayAttribute” 主 题 。 


5.14 跟踪 异常 从 何 而 来 


5.14.1 问题 


你 想 确 定 异常 是 在 什么 方法 中 被 捕获 的 ， 或 者 导致 异常 引发 的 方法 是 被 谁 调用 的 ， 以 帮助 
调试 问题 。 


5.14.2 ”解决 方案 


使 用 位 于 System.Runtime.CompilerServices 命名 空间 中 的 CallerMemberName, CallerFilePath 
和 CallerLineNumber 特性 (也 被 称 为 调用 方 信息 特性 ) 来 确定 调用 者 方法 。 


例如 ， 如 果 需 要 记录 捕 换 一 个 异常 的 catch 语句 块 的 位 置 ， 可 以 使 用 一 个 类 似 
RecordCatchBlock 的 方法 ， 代 码 如 下 所 示 。 


public void RecordCatchBlock(Exception ex, 
[CallerMemberName] string memberName = 
[CallerFilePath] string sourceFilePath = "", 
[CallerLineNumber] int sourceLineNumber = 0) 









































wn 
’ 


string catchDetails = 
$'(ex.GetType().Name) caught in member \"{memberName}\ 
$'in catch block encompassing line {sourceLineNumber} " + 
$'in file {sourceFilePath} " + 


S"with message \"{ex.Message}\""; 
Console.WriteLine(catchDetails); 


+ 


} 
然后 在 catch 语句 块 中 调用 此 方法 ， 如 下 所 示 。 


public void TestCallerInfoAttribs() 


{ 
try 
{ 
LibraryMethod(); 
} 
catch(Exception ex) 
RecordCatchBlock(ex) ; 
} 
} 








KIER TAERE RE, STIL PT ES eR, SS AR 
所 在 的 源码 文件 和 catch 语句 块 的 行 号 ， 而 不 需要 遍历 调用 堆栈 。 


LibraryException caught in member "TestCallerInfoAttribs" in catch block encompa 
ssing line 1303 in file C:\CSCB6\CSharpRecipes\ 
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05 DebuggingAndExceptionHandling.cs 
with message "Object reference not set to an instance of an object." 


还 可 以 使 用 这 些 特性 来 帮助 确定 什么 方法 调用 了 库 方 法 ， 因 为 有 时 候 难 以 调试 出 哪个 函数 
调用 了 库 方法 。 


public void LibraryMethod( 
[CallerMemberName] string memberName = 
[CallerFilePath] string sourceFilePath = "", 
[CallerLineNumber] int sourceLineNumber = 0) 














{ 
try 
{ =" 
// 执 行 一 些 库 行为 ， 
// 发 生 了 问题 
throw new NullReferenceException(); 
} 
catch(Exception ex) 
{ 
// 封 装 异 常 ,捕获 库 方法 被 调用 的 来 源 
throw new LibraryException(ex) 
{ 
CallerMemberName = memberName, 
CallerFilePath = sourceFilePath, 
CallerLineNumber = sourceLineNumber 
5 
} 
} 
利用 LibraryException， 在 运行 时 可 以 记录 调用 者 方法 的 特性 ， 与 原始 异常 同时 输出 。 
[Serializable] 
public class LibraryException : Exception 
{ 
public LibraryException(Exception inner) : base(inner.Message,inner) 
{ 
} 


public string CallerMemberName { get; set; } 
public string CallerFilePath { get; set; } 
public int CallerLineNumber { get; set; } 


public override void GetObjectData(SerializationInfo info, 
StreamingContext context) 


{ 
base.GetObjectData(info, context); 
info.AddValue("CallerMemberName", this.CallerMemberName) ; 
info.AddValue("CallerFilePath", this.CallerFilePath) ; 
info.AddValue("CallerLineNumber", this.CallerLineNumber ) ; 
} 


public override string ToString() => "LibraryException originated in " + 
$"member \"{CallerMemberName}\" " + 

$"on line {CallerLineNumber} " + 

S"in file {CallerFilePath} " + 


S"with exception details: {Environment.NewLine}" + 
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$"(InnerException.ToString()]"; 
} 


LibraryException.ToString 方法 提供 了 问题 的 摘要 。 


LLibraryException originated in member "TestCallerInfoAttribs" on line 1299 in 
file C:\CSCB6\CSharpRecipes\05_DebuggingAndExceptionHandling.cs with exception 
details: 
System.NullReferenceException: Object reference not set to an instance of an obj 
ect. 

at CSharpRecipes.DebuggingAndExceptionHandling.LibraryMethod(String memberNam 
e, String sourceFilePath, Int32 sourceLineNumber) in D:\PRJ32\Book_6_0\CS60_Cook 
book\CSCB6\CSharpRecipes\05_DebuggingAndExceptionHandling.cs:line 1318 


5.14.3 讨论 

因为 CallerInfo 特性 在 编译 时 确定 ， 所 以 它 在 运行 时 不 会 产生 从 堆栈 中 获取 前 一 方法 来 源 

,的 成 本 。 虽 然 不 像 完 整 的 堆栈 跟踪 那样 详尽 ， 但 它 是 一 种 更 廉价 和 更 简单 的 奉 代 ， 可 
给 你 方法 、 文 件 和 行 号 信息 ， 你 可 以 借 此 增强 异常 日 志 功 能 。 你 在 任何 时 候 都 能 让 收 到 

A PEE ac ae 知 到 你 的 方式 ) 中 带 有 这 类 信 

息 ， 生 活 会 变 得 更 加 轻松 。 

或 许 你 注意 到 了 CallerInfo 特性 需要 一 个 默认 值 。 


public void RecordCatchBlock(Exception ex, 
[CallerMemberName] string memberName = 
[CallerFilePath] string sourceFilePath = "", 
[CallerLineNumber] int sourceLineNumber = 0) 


ee ed 而 可 选 参数 需要 一 个 默 
认 值 。 你 仍然 能 够 调用 带 有 特性 的 方法 ， 不 需要 提供 参数 值 ， 如 下 所 示 。 


RecordCatchBlock(ex); 


5.14.44. ”参考 


MSDN x #4 P AY *CallerMemberNameAttribute" “CallerFilePathAttribute” 4] “Caller- 
LineNumberAttribute" i., 


5.15 在 异步 情境 下 处 理 异 党 


5.15.1 问题 


你 正在 使 用 async 和 await 来 调用 异步 方法 ， 需 要 能 够 捕获 此 方法 (或 多 个 方法 ) 执行 期 
间 引 发 的 任何 异常 。 


5.15.2 ”解决 方案 


在 处 理 单个 方法 调用 时 出 现 的 异常 时 ，.NET Framework 会 处 理 在 异步 调用 和 等 待 异步 返 
































wn 
’ 


























Iz] 
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之 间 出 现 的 异常 返回 ， 而 在 处 理 多 个 同时 调用 的 异步 方法 中 的 异常 时 ， 需 要 一 些 额 外 的 工 
作 来 提取 所 有 的 异常 细节 。 最 后 ， 在 处 理 一 个 异常 时 ， 可 以 在 catch 语句 块 中 调用 一 个 异 
步 方 法 来 完成 工作 。 

为 了 说 明 这 一 点 ， 我 们 来 看 一 个 很 常见 的 场景 : 一 个 名 叫 Bill 的 软件 开发 经 理 有 一 些 工 作 
用 户 故 事 1: Bill 需要 让 Steve 实 现 产品 中 的 一 个 新 功能 。 

Bill ZI Steve 的 办 公 桌 前 ， 要 求 他 实现 这 个 冲刺 (sprint) 中 的 新 功能 ， 然 后 离开 ， 由 
Steve 自己 来 实现 (与 Bill 的 要 求 异 步 进行 )。 


try 
{ 
































// Steve, get that project done! 
await SteveCreateSomeCodeAsync(); 


catch (DefectCreatedException dce) 


{ 
} 


Steve 像 所 有 开发 人 员 一 样 努 力 工作 ， 但 就 算是 我 们 中 最 好 的 人 也 会 有 不 顺利 的 一 
CK. Steve 磁 巧 在 按 要 求 在 SteveCreateSomeCodeAsync 中 实现 的 功能 中 出 现 了 一 个 缺 
陷 。 幸 和 运 的 是 ， 尽 管 Steve 以 异步 方式 执行 此 操作 ， 我 们 仍然 能 够 以 通常 的 方式 捕 
获 BeFecttreatedException 并 人 处理 它 ， 因 为 async 4H] await 支持 自动 将 异常 传输 
到 catch 语句 块 中 。( 在 5.15.3 市 中 有 更 多 关于 此 种 机 制 如 何 运 行 的 信息 。 请 查找 


ExceptionDispatchInfo | ) 
来 自 捕获 异常 的 输出 让 我 们 知道 问题 出 在 哪里 ， 所 以 Steve 晚 些 时 候 可 以 修复 它 。 


Steve introduced a Defect: A defect was introduced: (Null Reference on line 42) 


用 户 故事 2: Bil 有 大 量 的 功能 需要 由 Jay、Tom 和 Seth 实 现 
Bill 知道 Steve 很 忙 ， 所 以 他 来 到 团队 中 其 他 成 员 处 (Jay, Tom 和 Seth) ， 要 求 完成 这 个 
冲刺 中 的 一 些 新 功能 。 看 起 来 他 们 需要 周 六 来 加 班 。Jay、Tom 和 Seth 聚 在 一 起 ， 划 分 了 
工作 ， 然 后 同时 开始 编程 。 即 使 他 们 可 能 会 在 不 同 的 时 间 完 成 ，Bil 仍然 想 要 查找 到 他 们 
产生 的 任何 缺陷 。 

// 大 伙 , 这 个 周末 要 完成 新 的 功能 

// 你 们 最 好 快 一 点 

Task jayCode = JayCreateSomeCodeAsync(); 


Task tomCode = TomCreateSomeCodeAsync(); 
Task sethCode = SethCreateSomeCodeAsync(); 


Console.WriteLine($"Steve introduced a Defect: {dce.Message}"); 





























E 















































Task teamComplete = Task.WhenAll(new Task[] { jayCode, tomCode, sethCode }); 
try 
{ 


} 


catch 


{ 


await teamComplete; 











// 获得 动作 集合 引发 异常 的 信息 
var defectMessages = 
teamComplete.Exception?.InnerExceptions.Select(e => 
e.Message).ToList(); 
defectMessages?.ForEach(m => 
Console.WriteLine($"{m}")); 





} 


首先 ， 将 每 个 工作 单元 (JayCreateSomeCodeAsync, TomCreateSomeCodeAsync 和 SethCreate- 
SomeCodeAsync) 转变 为 一 个 Task。 然 后 调用 Task.WhenAll 方 法 来 创建 一 个 容器 Task 
(teanComplete) ， 它 将 在 所 有 单独 的 Task 都 完成 之 后 完成 。 

一 是 所 有 任务 都 完成 之 后 ， 如 果 任 何 一 个 Task 在 执行 过 程 中 出 现 异常 ，await 将 引发 
AggregateException。 这 个 AggregateException 可 以 通过 teamComplete.Exception 属性 来 
访问 ， 它 包含 了 一 个 InnerExceptions 列表 ， 其 类 型 为 ReadOnlyCollection<Exception>, 


因为 是 开发 人 员 引 起 了 这 些 异 常 ， 所 以 它们 大 多 是 DefectCreatedExceptions | 
生成 的 日 志 记 录 告 诉 我 们 团队 需要 在 哪里 改正 。 


A defect was introduced: (Ambiguous Match on line 2) 
A defect was introduced: (Quota Exceeded on line 11) 
A defect was introduced: (Out Of Memory on line 8) 


用 户 故事 3: Bil 想 要 记录 在 实现 一 项 新 功能 时 是 否 存在 任何 问题 

最 终 ，Bil 意识 到 他 需要 一 个 更 好 的 系统 来 确定 是 否 存在 引入 到 代码 中 的 缺陷 。Bil 在 
代码 中 添加 * 日 志 ， 当 捕获 到 DefectCreatedException 时 ， 将 缺陷 的 详细 信息 写 入 到 
EventLog 中 。 由 于 写 入 EventLog 可 能 会 影响 到 性 能 ， 他 决定 以 异步 方式 执行 此 操作 。 


try 
{ 
































await SteveCreateSomeCodeAsync(); 


catch (DefectCreatedException dce) 


{ 
await WriteEventLogEntryAsync("ManagerApplication", dce.Message, 
EventLogEntryType.Error); 
throw; 
} 


5.15.3 讨论 


Hl 代码 并 不 意味 着 你 不 再 需要 有 正确 的 错误 处 理 ， 它 只 是 将 过 程 复 杂 化 了 


. ISNA, Microsoft 的 C# 和 .NET 团队 做 了 大 量 工作 以 使 得 这 一 任务 尽 可 能 轻 
ay 


异步 等 待 这 些 操作 意味 着 它 们 在 一 个 上 下 文中 运行 ， 要么 是 当前 的 
SynchronizationContext， 要 么 是 Taskscheduler。 这 一 上 下 文 在 异步 方法 等 待 另 一 个 方法 
时 被 捕获 ， 之 后 在 异步 方法 继续 工作 时 恢复 。 


8 捉 的 上 下 文 取决 于 在 以 下 哪个 位 置 执 行 了 异步 方法 代码 。 
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。 用 户 界 面 (WinForms/WPF) : UI EFX 
。 ASP.NET: ASP.NET 请 求 上 下 文 
。 其 他 : 线程 池上 下 文 


在 用 户 故 事 1 中， 我 们 提 到 了 async 和 await 的 实现 用 到 了 一 个 











ExceptionServices.ExceptionDispatchInfo 的 类 ， 用 于 处 理 以 下 情形 : 








名 为 System.Runtime. 
在 一 个 线程 上 引发 


某 个 异常 ， 并 且 作 为 异步 操作 的 结果 ， 需 要 在 另 一 个 线程 上 捕获 该 异常 。 

















使 用 ExceptionDispatchInfo 可 以 捕获 在 一 个 线程 上 3 引发 的 异常 ， 然 





后 在 另 一 个 线程 上 重 











新 引发 ， 而 不 会 丢失 任何 信息 (异常 数据 和 堆栈 跟踪 )。 从 异常 处 型 











的 观点 上 来 看 ， 这 是 





await 一 个 async 方法 时 所 发 生 的 事情 。 


值得 注意 的 另外 一 点 是 ConfigureAwait 的 使 用 ， 它 允许 你 完成 async 方法 之 后 更 改 上 下 文 


恢复 的 行为 。 如 果 将 false 传递 给 ConfigureAwait， 它 将 不 会 尝试 恢 


await MyAsyncMethod().ConfigureAwait(false); 

















那么 在 它 恢 复 后 请 求 上 下 文 将 不 再 可 用 。 


这 个 努力 工作 的 团队 的 代码 展示 在 例 5-7 中 。 
例 5-7: 团队 工作 


public async Task TestHandlingAsyncExceptionsAsync() 


{ 








// 团队 生产 软件 


复原 始 上 下 文 。 


如 果 使 用 ConfigureAwait(false)， 则 在 await 完成 并 且 async 方法 恢复 之 后 
的 任何 代码 都 不 能 依赖 原始 的 上 下 文 ， 因 为 代码 继续 执行 所 在 的 线程 没有 
原始 的 上 下 文 信息 。 例 如 ， 如 果 async 方法 在 ASP.NET 的 上 下 文中 被 调用 ， 


// 经 理 让 Steve 去 编写 代码 ,引发 了 "DefectCreatedException" 异 常 
// 经 理 让 Jay Tom 和 Seth 去 编写 代码 ,都 引发 了 DefectCreatedException 














// 单个 asyn 方 法 调用 
try 





// Steve, 去 完成 项 目 
await SteveCreateSomeCodeAsync(); 





catch (DefectCreatedException dce) 


{ 


Console.WriteLine($"Steve introduced a Defect: {dce.Message}"); 


} 


// 多 个 async 方 法 (WaitAl1) 

// 大 伙 , 这 个 周末 要 完成 新 的 功能 

// 你 们 最 好 快 一 点 

Task jayCode = JayCreateSomeCodeAsync(); 
Task tomCode = TomCreateSomeCodeAsync(); 
Task sethCode = SethCreateSomeCodeAsync(); 


Task teamComplete = Task.WhenAll(new Task[] f jayCode, tomCode, sethCode }); 


try 
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{ 


await teamComplete; 























} 
catch 
{ 
// 获得 动作 集合 引发 异常 的 信息 
var defectMessages = 
teamComplete.Exception?.InnerExceptions.Select(e => 
e.Message).ToList(); 
defectMessages?.ForEach(m => 
Console.WriteLine($"{m}")); 
} 


// 在 异常 处 理 中 等 待 一 个 动作 
// 讨论 原始 引发 位 置 如 何 通 过 System.Runtime.ExceptionServices.ExceptionDispatchInfo 
// 进行 保留 





























try 
{ 
try 
{ 
await SteveCreateSomeCodeAsync(); 
} 
catch (DefectCreatedException dce) 
{ 
Console.WriteLine(dce.ToString()); 
await WriteEventLogEntry("ManagerApplication", dce.Message, 
EventLogEntryType.Error); 
throw; 
} 
} 
catch(DefectCreatedException dce) 
{ 
Console.WriteLine(dce.ToString()); 
} 


} 


public async Task WriteEventLogEntryAsync(string source, string message, 
EventLogEntryType type) 


{ 

await Task.Factory.StartNew(() => EventLog.WriteEntry(source, message, type)); 
} 
public async Task SteveCreateSomeCodeAsync() 
{ 

Random rnd = new Random(); 

await Task.Delay(rnd.Next(100, 1000)); 

throw new DefectCreatedException("Null Reference" ,42); 
} 
public async Task JayCreateSomeCodeAsync() 
{ 

Random rnd = new Random(); 

await Task.Delay(rnd.Next(100, 1000)); 

throw new DefectCreatedException("Ambiguous Match",2); 
} 
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public async Task TomCreateSomeCodeAsync() 


{ 


} 


Random rnd = new Random(); 
await Task.Delay(rnd.Next(100, 1000)); 
throw new DefectCreatedException("Quota Exceeded",11); 


public async Task SethCreateSomeCodeAsync() 


{ 


j 


Random rnd = new Random(); 
await Task.Delay(rnd.Next(100, 1000)); 
throw new DefectCreatedException("Out Of Memory", 8); 


自 定 义 的 DefectCreatedException 类 展示 在 例 5-8 中 。 


例 5-8: 缺陷 跟踪 
[Serializable] 
public class DefectCreatedException : Exception 


{ 


#region Constructors 

// 正常 的 异常 构造 函数 

public DefectCreatedException() : base() 
{ 

} 


public DefectCreatedException(string message) : base(message) 
{ 
} 


public DefectCreatedException(string message, Exception innerException) 
: base(message, innerException) 

{ 

} 


// 接受 新 参数 的 异常 构造 函数 
public DefectCreatedException(string defect, int line) : base(string.Empty) 
{ 

this.Defect = defect; 

this.Line = line; 


j 


public DefectCreatedException(string defect, int line, Exception innerException) 
: base(string.Empty, innerException) 

{ 
this.Defect = defect; 
this.Line = line; 


// 序列 化 构造 函数 

protected DefectCreatedException(SerializationInfo exceptionInfo, 
StreamingContext exceptionContext) 
: base(exceptionInfo, exceptionContext) 





4 
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} 


#endregion // Constructors 
#region Properties 

public string Defect { get; } 
public int Line { get; } 


public override string Message => 


$"A defect was introduced: ({this.Defect ?? "Unknown"} on line {this.Line})"; 


#endregion // Properties 


#region Overridden methods 

// ToString 方 法 

public override string ToString() => 
$"{Environment.NewLine}{this.ToFullDisplayString()}"; 

















// 用 于 序列 化 时 捕获 额外 字段 的 信息 
[SecurityPermission(SecurityAction.LinkDemand, 
Flags = SecurityPermissionFlag.SerializationFormatter ) ] 
public override void GetObjectData(SerializationInfo info, 
StreamingContext context) 











{ 
base.GetObjectData(info, context); 
info.AddValue("Defect", this.Defect); 
info.AddValue("Line", this.Line); 
#endregion // Overridden methods 


public string ToBaseString() -» (base.ToString()); 


5.15.4 参考 


MSDN X $4 RAY “async” “await” “AggregateException” "ConfigureAwait" 


Runtime. ExceptionServices.ExceptionDispatchInfo” = fil, 


5.16 ”有 选择 地 处 理 异 常 


5.16.1 问题 
你 想 要 只 处 理会 因 多 种 原因 而 引发 的 异常 中 的 某 个 特定 实例 。 


5.16.2 解决 方案 
使 用 异常 过 滤器 来 仅 捕获 想 要 处 理 的 状态 的 异常 。 








All “System. 


举例 来 说 ， 假 设 在 调用 一 个 数据 库 时 ， 你 想 要 以 不 同 的 方式 米 处 理 超时 情况 。 如 果 是 从 
ASP.NET WebApi 调用 ， 那 么 当 发 现 数据 库 超 时 错误 时 ， 你 也 许 想 要 返回 一 个 503 服务 不 可 

















用 的 消息 来 表明 服务 正 忙 。 
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ProtectedCallTheDatabase 方法 将 CaLLTheDatabase 方 法 封装 在 一 个 try-catch 语句 块 
中 ， 然 后 添加 了 一 个 异常 过 滤器 (使 用 when 关键 字 ) 检查 DatabaseException 分 配 的 
Number 属性 设置 为 -2 的 情况 。 当 一 个 DatabaseException 的 Number 属性 被 设置 为 -2 
时 ， 说 明 是 一 个 超时 (就 像 当 前 的 Microsoft 数据 库 提 供 的 )， 我 们 将 捕获 该 异常 并 处 理 
它 。 如 果 没 有 将 Number 设置 为 -2， 我 们 将 不 会 捕获 异常 ， 它 将 在 调用 堆栈 中 向 上 传播 到 
ProtectedCallTheDatabase 方法 的 调用 方 。 














private void ProtectedCallTheDatabase(string problem) 


{ 
try 
{ 
CaallTheDatabase(problem); 
Console.WriteLine("No error on database call"); 
} 
catch (DatabaseException dex) when (dex.Number == -2) // 观察 超时 
{ 
Console.WriteLine( 
"DatabaseException catch caught a database exception: " + 
$"(dex.Message]"); 
} 
} 


CallTheDatabase 方法 模拟 了 调用 数据 库 并 过 到 一 个 问题 ， 代 码 如 下 所 示 。 


private void CallTheDatabase(string problem) 





{ 
switch (problem) 
{ 
case "timeout": 
throw new DatabaseException( 
"Timeout expired. The timeout period elapsed prior to " + 
"completion of the operation or the server is not " + 
"responding. (Microsoft SQL Server, Error: -2).") 
{ 
Number = -2, 
Class = 11 
5 
case "Loginfail": 
throw new DatabaseException("Login failed for user") 
{ 
Number = 18456, 
5 
} 
} 


可 以 用 例 5-9 中 展示 的 三 种 方式 来 调用 ProtectedCallTheDatabase 方法 。 
例 5-9: 测试 异常 过 滤器 


Console.WriteLine("Simulating database call timeout"); 
try 
{ 


} 


ProtectedCallTheDatabase("timeout"); 





catch(Exception ex) 


{ 
} 


Console.WriteLine(""); 


Console.WriteLine($"Exception catch caught a database exception: [ex.Message]"); 


Console.WriteLine("Simulating database call login failure"); 


try 
{ 
ProtectedCallTheDatabase("loginfail"); 
} 
catch (Exception ex) 
{ 
Console.WriteLine($"Exception catch caught a database exception: {ex.Message}"); 
} 


Console.WriteLine(""); 


Console.WriteLine("Simulating successful database call"); 


try 
{ 
ProtectedCallTheDatabase("noerror"); 
} 
catch (Exception ex) 
{ 
Console.WriteLine($"Exception catch caught a database exception: {ex.Message}"); 
} 


Console.WriteLine(""); 
运行 输出 显示 在 例 5-10 中 。 
例 5-10: 异常 过 滤器 测试 的 输出 


Simulating database call timeout 
DatabaseException catch caught a database exception: Timeout expired. 


The timeout period elapsed prior to completion of the operation or the server 
is not responding. (Microsoft SQL Server, Error: -2). 


Simulating database call login failure 
Exception catch caught a database exception: Login failed for user 


Simulating successful database call 
No error on database call 


可 以 看 到 ， 超 时 是 在 ProtectedCallTheDatabase 的 catch 语句 块 中 捕获 的 ， 而 登录 失败 直 
到 在 测试 代码 中 返回 到 catch 语句 块 之 后 才 会 被 捕获 到 。 























5.16.3 讨论 

异常 过 滤器 允许 你 有 条 件 地 评估 catch 语句 块 是 否 要 捕获 一 个 异常 ， 这 是 非常 强大 的 ， 并 
允许 你 比 以 往 更 细 粒 度 地 仅 处 理 能 够 进行 处 理 的 异常 。 

使 用 异常 过 着 器 的 另 一 个 优点 是 它 不 需要 不 断 地 捕获 和 重新 引发 异常 。 如 果 做 得 不 正确 ， 
获 和 重新 引发 异常 会 影响 异常 的 调用 堆栈 并 且 隐 藏 错误 (更 多 细节 可 参考 范例 5.1, BY 
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5.1 节 )， 而 异常 过 滤器 允许 对 异常 进行 检查 其 至 执行 操作 (如 日 志 记 录 ) 且 不 会 干扰 异常 
的 原始 流程 。 为 了 做 到 不 干扰 ， 异 常 过 滤器 中 执行 的 代码 必须 返回 false， 以 使 异常 继续 
正常 传播 。 在 异常 过 滤器 中 用 于 判定 true 或 false 的 代码 应 保持 在 最 小 规模 ， 因 为 这 是 在 
catch 处 理 嚣 中， 适用 于 同样 的 规则 。 不 要 做 可 能 导致 其 他 异常 和 掩盖 初始 想 要 捕捉 的 原 
始 错误 条 件 的 事情 。 

DatabaseException 的 完整 请 单 如 例 5-11 中 所 示 。 


例 5-11; DatabaseException 类 


[Serializable] 
public class DatabaseException : DbException 


{ 











lin! 








public DatabaseException(string message) : base(message) ( ) 

public byte Class { get; set; } 

public Guid ClientConnectionId { get; set; } 

[DesignerSerializationVisibility(DesignerSerializationVisibility.Content)] 

public SqlErrorCollection Errors { get; set; } 

public int LineNumber { get; set; } 

public int Number { get; set; } 

public string Procedure { get; set; } 

public string Server { get; set; } 

public override string Source -» base.Source; 

public byte State { get; set; } 

public override void GetObjectData(SerializationInfo si, 
StreamingContext context) 


( 
} 


base.GetObjectData(si, context); 


5.16.4 B84 


MSDN 文档 中 的 “Exception Filters” 主 题 。 





第 6 章 


反射 和 动态 编程 





6.0 简介 


反射 (reflection) 是 .NET Framework 提供 的 一 种 机 制 ， 人 允许 开 发 人 员 审 视 一 个 应 用 是 如 何 
构造 的 。 使 用 反射 ， 可 以 获得 诸如 程序 集 名 称 以 及 一 个 给 定 程序 集 导 入 的 其 他 程序 集 等 信 
息 。 开 发 人 员 甚 至 可 以 动态 地 调用 给 定 程序 集 内 一 个 类 型 实例 的 方法 。 反 射 还 允许 用 户 动 
态 创 建 代 码 并 编译 成 一 个 驻 留 内 存 的 程序 集 或 者 构建 一 个 程序 集 内 的 类 型 记录 的 符号 表 。 


反射 是 Framework 的 一 项 非常 强大 的 特性 ， 受 到 运行 时 的 保护 。ReflectionPermission 
必须 被 授予 准备 访问 某 一 类 型 的 保护 或 私有 成 员 的 程序 集 。 如 果 只 准备 访问 一 个 公共 类 
型 的 公共 成 员 ， 那 就 不 需要 被 授予 ReflectionPermission。 代 码 访 问安 全 性 (code access 
security, CAS) 只 有 两 个 权限 集 默 认 授 予 所 有 反射 访问 ， 即 FuLLTrust 和 Everything, 
LocalIntranet fx IR 4E E & ReflectionEmit 特权 (允许 发 布 元 数据 并 生成 数据 集 ) 和 
MemberAccess 特权 (允许 对 程序 集中 类 型 的 方法 执行 动态 调用 )。 

本 章 中 ， 你 将 会 知道 如 何 使 用 反射 动态 地 调用 类 型 上 的 成 员 ， 计 算出 一 个 给 定 程序 集 所 依 
赖 的 所 有 程序 集 ， 并 且 审 视 程序 集 的 不 同类 型 的 信息 。 反 射 是 理解 各 个 元 素 如 何 被 集成 
到 NET 中 的 一 种 好 方法 ， 而 本 章 提供 了 学 习 起 点 。 

本 章 还 涵盖 了 C# 中 的 dynamic 关键 字 ， 它 由 .NET 中 的 动态 语言 运行 时 (dynamic 
language runtime, DLR) 提供 支持 。 它 用 来 帮助 扩展 Cft 在 运行 时 识别 一 个 对 象 的 类 型 ， 
而 不 是 编译 时 的 静态 类 型 ， 以 支持 动态 行为 。 要 使 用 这 些 功 能 ， 需 要 引用 System.Dynamic 
程序 集 和 命名 空间 。 

引入 DLR 是 为 了 支持 以 下 几 个 用 例 。 

。 将 其 他 语言 (如 Python Fil Ruby) 移植 到 .NET 
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。 支持 静态 语言 中 的 动态 特性 (如 C# 和 Visual Basic) 

。 使 语言 之 间 共 享 更 多 库 

。 RESERVE 〈 如 反射 ) 以 提高 性 能 ， 而 不 是 运行 时 每 次 都 确定 一 切 

DLR 提供 了 以 下 三 种 主要 服务 。 

。 表达 式 树 (用 以 表示 语言 语义 ， 如 在 LINQ 中 使 用 的 那些 ) 

。 调用 站 点 缓存 (在 第 一 次 执行 时 缓存 操作 特性 ) 

。 动态 对 象 互 操作 性 (通过 使 用 IDynamicMetaObjectProvider, DynamicMetaObject, 
DynamicObject 和 Expando0bject 实现 ) 


CH 中 提供 的 用 于 动态 编程 的 三 种 主要 构造 是 dynamic 类 型 〈 一 个 未 被 编译 时 检查 绑 定 的 
对 象 )、Expando0bject 类 (用 于 运行 时 构造 或 析 构 一 个 对 象 的 成 员 ) 和 DynamicObject 类 
(用 于 将 动态 行为 添加 到 自 定义 对 象 的 基 类 )。 本 章 论述 了 全 部 三 个 构造。 


6.1 列 出 引用 的 程序 集 


6.1.1 问题 


你 需要 确定 某 一 特定 程序 集 导 入 的 所 有 程序 集 。 该 信息 可 以 显示 该 程序 集 是 否 正在 使 用 一 
个 或 多 个 你 的 程序 集 ， 或 者 它 是 否 在 使 用 另 一 个 指定 的 程序 集 。 


6.1.2 解决 方案 
使 用 Assenbly.GetReferencedAssemblies 方法 ， 获 得 一 个 特定 程序 集 的 导入 程序 集 ， 如 例 
6-1 所 示 。 


例 6-1: 使 用 Assembly.GetReferencedAssemblies 方法 


public static void BuildDependentAssemblyList(string path, 
StringCollection assemblies) 
































{ 
// 维护 一 个 原始 程序 集 需 要 的 程序 集 列 表 
if(assemblies == null) 
assemblies = new StringCollection(); 





// 是 否 已 遇 到 过 这 个 程序 集 
if(assemblies.Contains(path)--true) 
return; 


try 
{ 


Assembly asm = null; 


// 在 字符 串 中 查找 常见 的 目录 分 隔 符 

// 以 确定 这 是 一 个 文件 名 还 是 路 径 

if ((path.IndexOf(@"\", 0, path.Length, StringComparison.Ordinal) != -1) || 
(path. IndexOf("/", 0, path.Length, StringComparison.Ordinal) != -1)) 














// 从 路 径 中 加 载 程序 集 
asm = Assembly.LoadFrom(path); 





} 
else 

// 尝试 用 于 程序 集 名 称 

asm = Assembly.Load(path); 
} 





// 将 程序 集 添 加 到 允 周 
if (asm != null) 
assemblies.Add(path); 


// 获得 引用 的 程序 集 


AssemblyName[] imports = asm.GetReferencedAssemblies(); 


8H 








// ER 
foreach (AssemblyName asmName in imports) 
t 
// 递归 调用 此 程序 集 以 获得 它 引用 的 新 模块 


BuildDependentAssemblyList(asmName.FullName, assemblies); 








j 
} 


catch (FileLoadException fle) 


// 跳 过 这 个 程序 集 


Console.WriteLine(fle); 


} 
该 代码 返回 一 个 StringCollection， 包 含 原 始 程序 集 、 所 有 导入 程序 集 以 及 导入 程序 集 的 
依赖 程序 集 。 
如 果 针 对 程序 集 C:\CSharpRecipes\bin\Debug\CSharpRecipes.exe 运行 该 方法 ， 将 得 到 下 列 
依赖 树 。 


Assembly C:\CSharpRecipes\bin\Debug\CSharpRecipes.exe has a dependency tree of 
these assemblies: 





C:\CSharpRecipes\bin\Debug\CSharpRecipes.exe 

mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken-b77a5c561934e089 

System, Version-4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089 

System.Configuration, Version=4.0.0.0, Culture=neutral, 
PublicKeyToken=b03f5f7f11d50a3a 

System.Xml, Version=4.0.0.0, Culture=neutral, PublicKeyTokenzb77a5c561934e089 

System.Data.SqlXml, Version=4.0.0.0, Culture=neutral, 
PublicKeyToken=b77a5c561934e089 

System.Security, Version=4.0.0.0, Culture=neutral, 

PublicKeyToken=b03f5f7f11d50a3a 

System.Core, Version=4.0.0.0, Culture=neutral, 

PublicKeyTokenzb77a5c561934e089 

System.Numerics, Version-4.0.0.0, Culture=neutral, 

PublicKeyToken=b77a5c561934e089 

System.Messaging, Version=4.0.0.0, Culture=neutral, 
PublicKeyToken-b03f5f7f11d50a3a 
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System.DirectoryServices, Version=4.0.0.0, Culture=neutral, 
PublicKeyToken=b03f5f7f11d50a3a 

System.Transactions, Version=4.0.0.0, Culture=neutral, 
PublicKeyToken=b77a5c561934e089 

System.EnterpriseServices, Version=4.0.0.0, Culture=neutral, 
PublicKeyToken=b03f5f7f11d50a3a 

System.Runtime.Remoting, Version=4.0.0.0, Culture=neutral, 
PublicKeyTokenzb77a5c561934e089 

System.Web, Version-4.0.0.0, Culture-neutral, PublicKeyToken-b03f5f7f11d50a3a 

System.Drawing, Version=4.0.0.0, Culture=neutral, 

PublicKeyToken=b03f5f7f11d50a3a 

System.Data, Version=4.0.0.0, Culture=neutral, 

PublicKeyToken=b77a5c561934e089 

System.Web.RegularExpressions, Version=4.0.0.0, Culture=neutral, 
PublicKeyToken=b03f5f7f11d50a3a 

System.Design, Version=4.0.0.0, Culture=neutral, 

PublicKeyToken=b03f5f7f11d50a3a 

System.Windows.Forms, Version=4.0.0.0, Culture=neutral, 
PublicKeyToken=b77a5c561934e089 

Accessibility, Version=4.0.0.0, Culture=neutral, 

PublicKeyToken=b03f5f7f11d50a3a 

System.Runtime.Serialization.Formatters.Soap, Version=4.0.0.0, 

Culture=neutral, 
PublicKeyToken=b03f5f7f11d50a3a 

System.Deployment, Version=4.0.0.0, Culture=neutral, 

PublicKeyToken=b03f5f7f11d50a3a 

System.Data.OracleClient, Version=4.0.0.0, Culture=neutral, 
PublicKeyToken=b77a5c561934e089 

System.Drawing.Design, Version=4.0.0.0, Culture=neutral, 
PublicKeyToken=b03f5f7f11d50a3a 

System.Web.ApplicationServices, Version=4.0.0.0, Culture=neutral, 
PublicKeyToken=31bf3856ad364e35 

System.ComponentModel.DataAnnotations, Version=4.0.0.0, Culture=neutral, 
PublicKeyToken=31bf3856ad364e35 

System.DirectoryServices.Protocols, Version=4.0.0.0, Culture=neutral, 
PublicKeyToken=b03f5f7f11d50a3a 

System.Runtime.Caching, Version=4.0.0.0, Culture=neutral, 
PublicKeyToken=b03f5f7f11d50a3a 

System.ServiceProcess, Version=4.0.0.0, Culture=neutral, 
PublicKeyToken=b03f5f7f11d50a3a 

System.Configuration.Install, Version=4.0.0.0, Culture=neutral, 
PublicKeyToken=b03f5f7f11d50a3a 

System.Runtime.Serialization, Version=4.0.0.0, Culture=neutral, 
PublicKeyToken=b77a5c561934e089 

System.ServiceModel. Internals, Version=4.0.0.0, Culture=neutral, 
PublicKeyToken=31bf3856ad364e35 

SMDiagnostics, Version=4.0.0.0, Culture=neutral, 

PublicKeyToken=b77a5c561934e089 

System.Web.Services, Version=4.0.0.0, Culture=neutral, 
PublicKeyToken=b03f5f7f11d50a3a 

Microsoft.Build.Utilities.v4.0, Version=4.0.0.0, Culture=neutral, 
PublicKeyToken=b03f5f7f11d50a3a 

Microsoft.Build.Framework, Version=4.0.0.0, Culture=neutral, 
PublicKeyToken=b03f5f7f11d50a3a 

System.Xaml, Version=4.0.0.0, Culture=neutral, 
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PublicKeyToken=b77a5c561934e089 

Microsoft.Build.Tasks.v4.0, Version=4.0.0.0, Culture=neutral, 
PublicKeyToken-b03f5f7f11d50a3a 

NorthwindLinq2Sql, Version=1.0.0.0, Culture=neutral, 
PublicKeyToken-fe85c3941fbcc4c5 

System.Data.Linq, Version-4.0.0.0, Culture=neutral, 
PublicKeyToken=b77a5c561934e089 

System.Xml.Linq, Version=4.0.0.0, Culture=neutral, 
PublicKeyToken=b77a5c561934e089 

EntityFramework, Version-6.0.0.0, Culture=neutral, 
PublicKeyToken=b77a5c561934e089 

Microsoft.CSharp, Version=4.0.0.0, Culture=neutral, 
PublicKeyToken-b03f5f7f11d50a3a 

System.Dynamic, Version-4.0.0.0, Culture=neutral, 

PublicKeyToken=b03f5f7f11d50a3a 

System.Data.DataSetExtensions, Version=4.0.0.0, Culture=neutral, 
PublicKeyTokenzb77a5c561934e089 


6.1.3 讨论 

获得 一 个 程序 集中 的 导入 类 型 对 于 确定 另 一 程序 集 正 在 使 用 哪些 程序 集 非常 有 用 。 这 一 知 
识 对 学 习 使 用 一 个 新 程序 集 很 有 帮助 。 该 方法 还 有 助 于 在 发 布 前 确定 程序 集 之 间 的 依赖 
性 ， 或 者 在 你 被 限制 不 能 使 用 或 导出 程序 集中 的 特定 类 型 时 执行 合 规 管 理 。 

System.Ref lection.Assembly 类 的 GetReferencedAssemblies 方法 获得 所 有 导入 程序 集 的 列 
表 。 该 方法 不 接受 任何 参数 ， 会 返回 一 个 AssemblyName 对 象 数组 而 不 是 一 个 Type 数组 。 
AssemblyName 类 型 由 名 称 、 版 本 、 区 域 信息 、 公 钥 / 私 钥 对 以 及 其 他 数据 组 成 ， 这 些 成 员 
允许 你 访问 对 应 程序 集 的 信息 。 

若 要 对 当前 的 可 执行 文件 调用 BuildDependentAssemblyList 方法 ， 可 运行 下 面 的 代码 示例 。 


string file = GetProcessPath(); 


























StringCollection assemblies = new StringCollection(); 
ReflectionAndDynamicProgramming.BuildDependentAssemblyList( file, assemblies) ; 
Console.WriteLine($"Assembly {file} has a dependency tree of these 
assemblies: {Environment .NewLine}"); 

foreach(string name in assemblies) 

{ 

} 


此 处 展示 的 GetProcessPath 返回 进程 可 执行 文件 的 当前 路 径 。 


private static string GetProcessPath() 


( 


Console.WriteLine($"\t{name}{Environment .NewLine}") ; 





// 修正 路 径 ,以 便 在 调试 器 中 运行 时 返回 原始 文件 

string processName = Process.GetCurrentProcess().MainModule.FileName; 
int index = processName.IndexOf("vshost", StringComparison.Ordinal); 
if (index != -1) 

{ 
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string first 
int numChars 


processName.Substring(0, index); 
processName.Length - (index + 7); 


string second = processName.Substring(index + 7, numChars); 


processName = first + second; 


} 


return processName; 


} 


注意 这 个 方法 无 法 列 出 通过 Assembly Ref lectionOnlyLoad* 加 载 的 程序 集 ， 因 为 它 只 4 


编译 时 的 引用 。 








6.1.4 参考 





























将 反射 加 载 用 于 审视 的 程序 集 时 ， 应 当 使 用 RefLection0nLyLoad* 方法 。 这 
些 方法 不 允许 执行 来 自 加 载 程序 集 的 代码 。 原 因 是 你 可 能 不 知道 自己 是 否 正 
在 加 载 包含 了 恶意 代码 的 程序 集 。 这 些 方法 可 防止 所 有 恶意 代码 的 执行 。 














MSDN 文档 中 的 “Assembly 类 ”主题 。 


6.2 ”确定 程序 集中 的 类 型 特征 


6.2.1 问题 


你 需要 找到 一 个 程序 集中 具有 某 些 特征 的 类 型 ， 例 如 以 下 这 些 。 





。 通过 方法 名 称 





。 在 程序 集 外 部 可 用 的 类 型 











。 可 序列 化 类 型 
。 给 定 类 型 的 子 类 
M T 


6.2.2 解决 方案 





使 用 反射 来 枚 举 与 你 正在 寻找 的 特征 匹配 的 类 型 。 对 于 我 们 列 出 提纲 的 特征 ， 可 以 使 用 表 





6-1 中 列 出 的 方法 。 
表 6-1: 根据 特征 查找 类 型 





特 dE 反射 方法 
方法 名 Type.GetMember 
导出 类 型 AssembLy.GetExportedTypes() 








可 序列 化 类 型 Type. IsSerializeable 
类 型 的 子 类 Type.IsSubclassOf 
KEXA Type.GetNestedTypes 





要 在 一 个 程序 集中 按 名 称 查 找 方法 ， 可 使 用 扩展 方法 GetMembersInAssembly， 代 码 如 下 
所 示 。 


public static IEnumerable<MemberInfo> GetMembersInAssembly(this Assembly asm, 
string memberName) => 
from type in asm.GetTypes() 
from ms in type.GetMember(memberName, MemberTypes.All, 
BindingFlags.Public | BindingFlags.NonPublic | 
BindingFlags.Static | BindingFlags.Instance) 
select ms; 


GetMembersInAssembly 使 用 Type.GetMember 来 搜索 具有 匹配 名 称 的 所 有 成 员 并 返 
MethodInfo 的 集合 。 





Iz] 


var members - asm.GetMembersInAssembly(memberSearchName); 


对 于 在 程序 集 外 部 可 用 的 类 型 ， 可 使 用 Assembly.GetExportedTypes 获得 一 个 程序 集 的 导出 
类 型 列表 ， 代 码 如 下 所 示 。 


var types = asm.GetExportedTypes(); 


要 确定 一 个 程序 集中 的 Serializable 类 型 ， 可 使 用 扩展 方法 GetSerializableTypes, {th 
如 下 所 示 。 
public static IEnumerable<Type> GetSerializableTypes(this Assembly asm) => 
from type in asm.GetTypes() 
where type.IsSerializable && 


!type.IsNestedPrivate //， 过 滤 掉 
select type; 


GetSerializableType 使 用 Type.IsSerializable 属性 确定 类 型 是 否 支 持 序 列 化 并 返回 一 组 
可 序列 化 类 型 。 不 用 测试 每 个 类 型 实现 的 接口 和 特性 ， 查 询 Type. IsSerializable 属性 就 
可 以 确定 它 是 否 被 标记 为 可 序列 化 。 


var serializeableTypes = asm.GetSerializableTypes(); 


要 获得 一 个 程序 集中 子 类 化 茶 个 特定 类 型 的 类 型 集 ， 可 使 用 扩展 方法 GetSubclasses- 
ForType， 代 码 如 下 所 示 。 


public static IEnumerable<Type> GetSubclassesForType(this Assembly asm, 
Type baseClassType) => 


名 类 型 


Il 














from type in asm.GetTypes() 
where type.IsSubclassOf(baseClassType) 
select type; 


GetSubclassesForType 使 用 Type.IsSubclassOf 方法 确定 一 个 程序 集 有 哪些 类 型 子 类 化 
了 指定 类 型 ， 它 接受 一 个 程序 集 路 径 字 符 串 和 代表 基 类 的 一 个 类 型 。 该 方法 返回 一 个 
IEnumerable<Type>， 代 表 传 递 给 baseClassType 参数 的 类 型 的 子 类 。 在 示例 中 ， 首 先 从 当 
前 进程 中 获得 程序 集 路 径 ， 然 后 将 CSharpRecipes.ReflectionUtils+Base0Overrides 设置 
为 测试 子 类 的 类 型 。 调 用 GetSubCLassesForType， 并 返回 一 个 IEnumerable<Type>, {thY 
如 下 所 示 。 
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Type type = Type.GetType( 
"CSharpRecipes.ReflectionAndDynamicProgramming+BaseOverrides"); 
var subClasses = asm.GetSubclassesForType( type) ; 


BA, BWve mre MRE, EHH RAE GetNestedTypes， 代 码 如 下 所 示 。 


public static IEnumerabLe<Type> GetNestedTypes(this Assembly asm) => 
from t in asm.GetTypes() 

from t2 in t.GetNestedTypes(BindingFlags.Instance | 
BindingFlags.Static | 
BindingFlags.Public | 
BindingFlags.NonPublic) 

where !t2.IsEnum && !t2.IsInterface 8& 

!t2.IsNestedPrivate // 过 滤 掉 匿名 类 型 
select t2; 








GetNestedTypes 使 用 Type.GetNestedTypes 方法 ， 并 审视 程序 集中 的 每 个 类 型 以 确定 它 是 否 
BERE, BAFI. 


var nestedTypes = asm.GetNestedTypes(); 








6.2.3 讨论 

你 为 什么 应 该 关心 这 些 关于 程序 集中 类 型 的 随机 事实 呢 ? Ay EMRE A B REB AG Iz 
如 何 构建 的 ， 发 现 你 可 能 会 允许 或 不 会 允许 的 编码 实践 。 让 我 们 单独 看 看 每 一 项 ， 以 便 知 
道 为 什么 你 也 许 想 要 了 解 它 。 

1. 方法 名 

memberName 参数 可 以 包含 通配符 *， 表 示 任 意 单个 或 多 个 字符 。 因 此 ， 要 查找 以 字符 串 
"Test" 开头 的 所 有 方法 ， 可 以 将 字符 串 "Test*" 传递 给 memberName 参数 。 要 注意 ，memberName 


参数 是 区 分 大 小 写 的 ， 但 asmPath 参数 不 是 。 如 果 你 想 要 不 区 分 大 小 写 的 成 员 查 找 ， 可 将 
BindingFLags.IgnoreCase 标志 添加 到 Type.GetMember 调用 的 其 他 BindingFlags 中 。 


System. Type 类 的 GetMember 方法 对 于 查找 一 个 类 型 中 的 一 个 或 多 个 方法 非常 有 用 。 该 方法 
返回 一 个 MemberInfo 对 象 数 组 ， 描 述 了 匹配 给 定 参 数 的 所 有 成 员 。 


* 字符 只 有 在 name 参数 字符 串 末 尾 才 用 作 通 配 符 。 如 果 放 置 在 字符 串 中 的 
其 他 位 置 ， 则 不 会 将 其 视 为 通配符 。 此 外 ， 为 确保 返回 所 有 成 员 ，* 必须 是 
name 参数 中 的 唯一 字符 。 诸 如 ? 之 类 的 其 他 通配符 都 不 受 支持 。 
























































获得 了 一 个 MemberInfo 对 象 的 数组 之 后 ， 你 需要 检查 这 些 成 员 的 类 型 。MemberInfo 类 包含 
一 个 MemberType 属性 ， 返 回 一 个 System.Reflection.MemberTypes 枚 举 值 ， 它 可 以 是 表 6-2 
中 定义 的 ALL 之 外 的 任何 值 。 


表 6-2: MemberTypes 枚 举 值 











枚 举 值 定 x 
All 所 有 成 员 类 型 
Constructor 一 个 构造 国 数 成 员 








8 


























枚 举 值 nz M 

Custon 一 个 自 定义 成 员 类 型 

Event 个 事件 成 员 

Field 一 个 字段 成 员 

Method 一 个 方法 成 员 

NestedType -DREK 

TypeInfo 一 个 代表 TypeInfo 成 员 的 类 型 成 员 
2. 导出 类 型 





获得 一 个 程序 集中 的 导出 类 型 在 确定 该 程序 集 的 公共 接口 时 非常 有 用 。 这 种 能 力 非 常 
有 助 于 学 习 使 用 一 个 新 的 程序 集 ， 或 者 可 以 帮助 程序 集 的 开发 人 员 确 定 该 程序 集 的 所 
有 访问 点 ， 以 检验 它们 对 于 恶意 代码 足够 安全 。 要 获得 这 些 导 出 类 型 ， 可 使 用 System. 
Reflection.Assembly 类 型 上 的 GetExportedTypes 方法 。 导 出 的 类 型 由 从 该 程序 集 外 部 可 
公共 访问 的 所 有 类 型 构成 。 一 个 类 型 可 能 具有 公共 访问 性 ， 但 从 程序 集 外 部 不 可 访问 。 以 
下 列 代码 为 例 。 


public class Outer 


{ 























public class Inner {} 
private class SecretInner {} 


} 


导出 的 类 型 是 Outer 和 0uter.Inner， 类 型 SecretInner 未 被 导出 到 该 程序 集 的 外 部 。 如 果 
将 Out 的 可 达 性 由 public 修改 为 private， 就 没有 了 能 够 外 部 访问 的 类 型 ， 因 为 Outer 类 
上 的 private， 所 以 Inner 类 访问 级 别 降低 。 


3. 可 序列 化 类 型 

使 用 SerializableAttribute 特性 可 将 一 个 类 型 标记 为 可 序列 化 的 。 测 试 一 个 类 型 上 的 
SerializableAttribute 属性 将 会 导致 大 量 的 工作 。 这 是 因为 SerializableAttribute 是 一 
种 不 可 思议 的 特性 ，C# 编译 器 在 编译 时 实际 上 去 掉 了 标记 代码 。 使 用 ildasm (.NET 平台 
的 反 编译 器 )， 你 将 看 到 这 一 自 定义 特性 并 不 存在 ， 通 常会 看 到 针对 每 个 自 定义 特性 的 一 
个 .custom 记录 ， 但 SerializableAttribute 不 是 。C# 编译 器 移 除 了 它 ， 取 而 代 之 的 是 ， 
在 类 的 元 数据 中 设置 了 一 个 标志 。 在 源 代码 中 ， 它 看 起 来 好 像 一 个 自 定义 特性 ， 但 它 编 译 
为 一 个 小 特性 集中 的 一 个 特性 ， 在 元 数据 中 有 特殊 表示 。 这 就 是 它 在 反射 API 中 得 到 特殊 
对 符 的 原因 。 幸 运 的 是 ， 你 不 必 完 成 所 有 的 工作 。 如 果 使 用 SerializableAttribute 将 当 
前 类 型 标记 为 可 序列 化 的 ， 那 么 Type 类 型 上 的 IsSerializable 属性 返回 true, AMZ 
性 返回 false, 

4. 类 型 的 子 类 

Type 类 上 的 IsSubclassOf 方法 允许 你 确定 当前 类 型 是 否 传递 给 该 方法 的 类 型 的 一 个 子 类 。 
通过 了 解 一 个 类 型 是 否 被 子 类 化 ， 可 以 探索 团队 或 公司 创建 的 类 型 层次 结构 ， 从 而 带 来 代 
码 重 用 、 重 构 或 更 好 理解 代码 库 中 依赖 的 机 会 。 







































































反射 和 动态 编程 | 255 


5. KERB 

ik Whe he ER, BY ae ch a A ET IK A. KT SA TREE 
定 一 个 类 型 将 包含 另 一 个 类 型 。 例 如 ， 修 饰 器 设计 模式 和 状态 设计 模式 使 用 了 对 象 包 含 。 
GetNestedTypes 扩展 方法 使 用 一 个 LINQ 查询 来 查询 asmPath 参数 指定 的 程序 集中 的 所 有 
类 型 。LINQ 查询 还 使 用 了 Type 类 的 GetNestedTypes 方法 来 查询 程序 集中 的 骨 套 类 型 。 

点 运算 符 通 常用 于 分 隔 命 名 空间 和 类 型 ， 但 是 般 套 类 型 有 些 特殊 。 在 反射 API PORE 
类 型 时 ， 它 们 在 其 完全 限定 名 中 使 用 + 与 其 他 类 型 分 开 。 通 过 将 这 一 完全 限定 名 传递 给 静 
AS GetType 方法 ， 可 以 获得 它 所 代表 的 实际 类 型 。 

这 些 方法 返回 一 个 代表 typename 参数 标识 的 类 型 的 Type 对 象 。 


调用 Type.GetType 以 获得 在 动态 程序 集 (使 用 在 System.RefLection.Emit 命 
名 空间 中 定义 的 类 型 所 生成 的 程序 集 ) 中 定义 的 一 个 类 型 ， 如 果 该 程序 集 尚 
未 持久 化 到 磁盘 ， 那 么 会 返回 一 个 nuLL。 通 常 应 该 使 用 动态 程序 集 Assembly 
对 象 和 静态 Assembly.GetType 方法 。 


















































6.2.4 ”参考 


MSDN 文档 中 的 “Assembly 2E” “Type 2E” "TypeAttributes fX 4s” “BindingFlags 枚 举 ” 
和 “MemberInfo 类 ”主题 。 


6.3 ”确定 继承 特征 


6.3.1 问题 
你 需要 确定 类 型 的 以 下 两 个 继承 特征 。 


。 继承 层次 结构 
。 被 重 写 的 基 类 方法 


6.32 ”解决 方案 
使 用 反射 来 枚 举 继承 链 和 基 类 方法 重 写 ， 如 表 6-3 所 示 。 
0-3. 根据 特征 查找 类 型 














特 4E 反射 方法 
继承 层次 结构  Type.BaseType 
基 类 方法 MethodInfo.GetBaseDefinition 


使 用 扩展 方法 GetInheritanceChain 来 获得 单个 类 型 的 整个 继承 层次 结构 。 
GetInheritanceChain 使 用 GetBaseTypes 方法 枚 举 类 型 ， 然 后 将 默认 顺序 反 转 以 从 基 类 
到 派生 类 的 排序 顺序 提供 枚 举 列 表 。 换 名 话说 ， 当 GetBaseTypes 遍历 每 个 遇 到 的 类 型 





























的 BaseType 时 ， 类 型 列表 的 结果 是 从 最 大 派生 深度 到 最 小 派生 深度 的 顺序 ， 因 此 调用 
Reverse 以 将 列表 排序 为 最 小 派生 深度 的 类 型 (Object) 在 最 前 面 ， 代 码 如 下 所 示 。 
public static IEnumerable<Type> GetInheritanceChain(this Type derivedType) => 


(from t in derivedType.GetBaseTypes() 
select t).Reverse(); 





private static IEnumerable<Type> GetBaseTypes(this Type type) 


{ 
Type current = type; 
while (current != null) 
{ 
yield return current; 
current = current.BaseType; 
} 
} 

















如 果 你 想 要 对 程序 集中 的 所 有 类 型 执行 此 操作 ， 可 以 使 用 扩展 方法 GetTypeHierarchies, 
它 使 用 自 定义 的 TypeHierarchy 类 来 表示 派生 类 型 及 其 继承 链 。 


public class TypeHierarchy 


{ 





public Type DerivedType { get; set; } 
public IEnumerable<Type> InheritanceChain { get; set; } 


} 


public static IEnumerable<TypeHierarchy> GetTypeHierarchies(this Assembly asm) => 
from Type type in asm.GetTypes() 
select new TypeHierarchy 


{ 
DerivedType = type, 
InheritanceChain = GetInheritanceChain(type) 
E 
GetTypeHierarchies 将 每 个 类 型 表现 为 DerivedType， 并 使 用 GetInheritanceChain 来 确定 
类 型 的 InheritanceChain, 


要 确定 基 类 方法 是 否 被 重 写 ， 可 使 用 MethodInfo.GetBaseDefinition 方法 来 确定 基 类 中 的 
哪个 方法 被 重 写 了 。 例 6-2 中 所 示 的 扩展 方法 GetMethod0verrides 检查 类 中 所 有 的 公开 实 
例 方 法 并 显示 哪些 方法 重 写 了 它们 各 自 的 基 类 方法 。 该 方法 还 确定 被 重 写 的 方法 位 于 哪个 
基 类 。 此 扩展 方法 基于 Type 并 使 用 类 型 查找 重 写 的 方法 。 
例 6-2: GetMethodOverrides 方法 

public class ReflectionUtils 


{ 














public static IEnumerable<MemberInfo> GetMethodOverrides(this Type type) => 
from ms in type.GetMethods(BindingFlags.Instance | 
BindingFlags.NonPublic | BindingFlags.Public | 
BindingFlags.Static | BindingFlags.DeclaredOnly) 
where ms !- ms.GetBaseDefinition() 
select ms.GetBaseDefinition; 
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下 一 个 扩展 方法 GetBaseMethodOver ridden 使 你 可 以 确定 是 否 某 个 特定 的 方法 重 写 了 其 基 类 
中 的 方法 ， 并 返回 与 被 重 写 方法 对 应 的 MethodInfo。 它 同样 扩展 了 Type， 参 数 为 完整 的 方 
法 名 称 和 表示 其 参数 类 型 的 Type 对 象 数 组 ， 代 码 如 下 所 示 。 


public class ReflectionUtils 


{ 








public static MethodInfo GetBaseMethodOverridden(this Type type, 
string methodName, Type[] paramTypes) 
{ 
MethodInfo method = type.GetMethod(methodName, paramTypes); 
MethodInfo baseDef - method?.GetBaseDefinition(); 
if (baseDef !- method) 


{ 


bool foundMatch = (from p in baseDef.GetParameters() 
join op in paramTypes 
on p.ParameterType.UnderlyingSystemType 
equals op.UnderlyingSystemType 
select p).Any(); 


if (foundMatch) 
return baseDef; 


j 


return null; 


6.3.3 讨论 
1. 继承 层次 结构 
不 幸 的 是 ， 不 存在 Type 类 的 一 个 属性 可 以 获得 一 个 类 型 的 继承 层次 结构 。 不 过 ， 本 范例 中 
的 GetInheritanceChain 方法 可 以 做 到 这 一 点 ， 只 需要 传人 要 获取 继承 层次 结构 的 类 型 的 
type 参数 。GetTypeHierarchies 只 需要 一 个 程序 集 参数 ， 因 为 它 生 成 了 程序 集中 所 有 类 型 
的 继承 层次 结构 。 

本 范例 的 核心 代码 位 于 GetBaseTypes 方法 。 这 是 一 个 枚 举 器 方法 ， 它 遍历 每 个 继承 的 类 
型 ， 直 至 找到 最 终 的 基 类 它 总 会 是 一 个 object 类 。 一 旦 它 到 达 这 一 最 终 基 类 ， 便 会 停 
IEi&fE. GetBaseTypes 返回 的 IEnumerable<Type> 包含 了 所 有 基 类 。 

要 显示 某 个 类 型 的 继承 链 ， 可 以 使 用 DisplayInheritanceChain 方法 调用 。 


private static void DisplayInheritanceChain(IEnumerable<Type> chain) 


{ 














cas 





StringBuilder builder = new StringBuilder(); 
foreach (var type in chain) 
{ 
if (builder.Length == 0) 
builder .Append(type.Name) ; 
else 
builder .AppendFormat($"<-{type.Name}"); 
} 
Console.WriteLine($"Base Type List: {builder.ToString()}"); 





要 显示 一 个 程序 集中 所 有 类 型 的 继承 层次 结构 ， 可 以 结合 使 用 GetTypeHierarchies 和 
DisplayInheritanceChain， 代 码 如 下 所 示 。 
// 程序 集中 的 所 有 类 型 


var typeHierarchies = asm.GetTypeHierarchies(); 
foreach (var th in typeHierarchies) 








// 递归 所 有 基 类 

Console.WriteLine($"Derived Type: {th.DerivedType.FullName}") ; 
DisplayInheritanceChain(th.InheritanceChain); 
Console.WriteLine(); 


} 
这 些 方法 产生 如 下 输出 。 


Derived Type: CSharpRecipes.Reflection 

Base Type List: Object<-Reflection 

Derived Type: CSharpRecipes.ReflectionUtils+BaseOverrides 
Base Type List: Object<-BaseOverrides 





Derived Type: CSharpRecipes.ReflectionUtils+DerivedOverrides 
Base Type List: Object<-BaseOverrides «-DerivedOverrides 


该 输出 显示 ， 当 查看 CSharpRecipes “py % 2 [B] rh Hy Reflection 类 时 ， 其 基 类 型 4 

表 (或 称 作 继 承 层次 结构 ) 以 Object 开头 (与 .NET 中 的 所 有 类 和 结构 类 似 )。 概 

类 BaseOverrides 还 显示 一 个 以 Object 开头 的 基 类 型 列表 。 般 套 类 DerivedOverrides 
一 个 更 有 趣 一 些 的 基 类 型 列表 ， 其 中 DerivedOverrides 从 BaseOverrides 派生 ， 而 

BaseOverrides 从 Object 派生 。 


2. 被 重 写 的 基 类 方法 

如 果 没 有 System.Reflection.MethodInfo 类 型 的 GetBaseDefinition 方法 ， 那 么 确定 哪些 
方法 重 写 了 其 基 类 方法 是 一 件 非 常 烦琐 的 事情 。 该 方法 没有 参数 ， 返 回 一 个 对 应 于 基 类 中 
被 重 写 方法 的 MethodInfo 对 象 。 如 果 该 方法 被 用 于 一 个 代表 未 被 重 写 方法 的 MethodInfo 


对 象 〈 与 用 于 某 个 虚 或 抽象 方法 的 情况 相同 )， 那 么 GetBaseDefinition 返回 原始 的 
MethodInfo 对 象 。 


当 方 法 名 及 其 参数 数组 都 被 传人 GetBaseMethodoverridden 时 ， 会 调用 Type 对象 的 
GetMethod 方法 ， 否 则 会 将 GetMethods 用 于 GetMethodoverrides。 如 果 正 确 地 定位 了 方法 
并 获得 了 其 MethodInfo 对 象 ， 则 会 在 MethodInfo 对 象 上 调用 GetBaseDefinition 方法 ， 
以 获得 继承 层次 中 最 近 基 类 中 的 第 一 个 被 重 写 的 方法 。 将 该 MethodInfo 的 类 型 与 调用 了 
GetBaseDefinition 方法 的 MethodInfo 的 类 型 进行 比较 。 如 果 两 个 对 象 相同 ， 那 么 这 意味 
着 所 有 基 类 中 都 没有 被 重 写 的 方法 ， 因 此 ， 不 会 返回 任何 内 容 。 该 方法 只 会 返回 被 重 写 的 
Hik: 如果 没有 方法 被 重 写 ， 则 返回 null, 


5, 
下 列 代 码 展示 了 如 何 使 用 这 些 重 载 方法 。 


Type derivedType = 
asm.GetType("CSharpRecipes.ReflectionAndDynamicProgramming+DerivedOverrides", 
true, true); 
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var methodOverrides = derivedType.GetMethodOverrides(); 
foreach (MethodInfo mi in methodOverrides) 





t 
Console.WriteLine(); 
Console.WriteLine($"Current Method: {mi.ToString()}"); 
Console.WriteLine($"Base Type FullName: {mi.DeclaringType.FullName}"); 
Console.WriteLine($"Base Method: {mi.ToString()}"); 
// 列 出 此 方法 的 类 型 
foreach (ParameterInfo pi in mi.GetParameters()) 
{ 
Console.WriteLine($"\tParam {pi.Name} : {pi.ParameterType.ToString()}"); 
} 
} 
// 寻找 更 多 重 载 
string methodName = "Foo"; 


var baseTypeMethodInfo = derivedType.GetBaseMethodOverridden(methodName, 
new Type[3] { typeof(long), typeof(double), typeof(byte[]) }); 
Console.WriteLine( 
$"{Environment.NewLine}For [Type] Method: [{derivedType.Name}]" + 
$" {methodName}") ; 
Console.WriteLine( 
$"Base Type FullName: {baseTypeMethodInfo.ReflectedType.FullName}"); 
Console.WriteLine($"Base Method: {baseTypeMethodInfo}"); 
foreach (ParameterInfo pi in baseTypeMethodInfo.GetParameters()) 


// 列 出 参数 以 便 了 解 取得 了 哪 一 个 
Console.WriteLine($"\tParam {pi.Name} : {pi.ParameterType.ToString()}"); 


} 


在 使 用 代码 中 ， 通 过 Process 类 获得 指向 测试 代码 程序 集 (CSharpRecipes.exe) 的 路 径 。 
然后 使 用 它 查 找 在 ReflectionUtils 类 中 定义 的 DerivedOverrides 类 ， 它 从 BaseOverrides 
类 派生 。pDerivedoverrides 和 Base0verrides 如 下 所 示 。 


public abstract class BaseOverrides 


{ 
public abstract void Foo(string str, int i); 
public abstract void Foo(long l, double d, byte[] bytes); 
} 
public class DerivedOverrides : BaseOverrides 
{ 
public override void Foo(string str, int i) 
{ 
} 
public override void Foo(long 1, double d, byte[] bytes) 
{ 
} 
} 


GetMethodOverrides 返回 它 在 Ref lection.DerivedOverrides 类 型 中 找 出 的 每 个 方法 的 
所 有 被 重 写 的 方法 。 如 果 和 希望 显示 所 有 重 写 方法 及 其 相应 被 重 写 的 方法 ， 那 么 可 以 从 
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GetMethods 方法 调用 中 移 除 BindingFlags.DeclaredOnly 绑 定 枚 举 ， 代 码 如 下 所 示 。 


return from ms in type.GetMethods(BindingFlags.Instance | 
BindingFlags.NonPublic | BindingFlags.Public) 
where ms != ms.GetBaseDefinition() 
select ms.GetBaseDefinition(); 


GetBaseMethodOverridden 传 入 一 个 方法 名 以 及 该 方法 的 参数 ， 以 根据 这 些 参数 查找 匹配 签 
名 的 重 写 版 本 。 在 本 例 中 ， 方 法 Foo 的 参数 类 型 是 long、double 和 byte[]。 访 方法 显示 
DerivedOverrides.Foo 重 写 的 方法 。 


6.3.4 ”参考 


MSDN 文档 中 的 “Assembly 2E" “Type.BaseType 方法 ”“MethodInfo 类 ”和 “ParameterInfo 


6.4 使 用 反射 调用 成 员 


6.4.1 问题 


你 有 一 个 方法 名 列表 ， 希望 在 应 用 程序 内 动态 地 调用 它们 。 当 代码 运行 时 ， 将 名 称 从 列表 
中 取出 并 尝试 调用 这 些 方法 。 这 一 技术 对 于 创建 组 件 测试 工具 非常 有 用 ， 可 以 用 于 从 一 个 
XML (或 JSON) 文件 中 读 入 方法 并 用 给 定 的 参数 执行 。 


6.4.2 ”解决 方案 


例 6-3 所 示 的 TestReflectionInvocation 方法 调用 ReflectionInvoke 方法 ， 后 者 打开 XML 
配置 文件 ， 使 用 LINQ 读 入 测试 信息 并 执行 每 个 测试 方法 。 


例 6-3: 通过 反射 调用 成 员 


public static void TestReflectionInvocation() 
































{ 
XDocument xdoc = 
XDocument.Load(@"..\..\SampleClassLibrary\SampleClassLibraryTests.xmL"); 
ReflectionInvoke(xdoc, Q"SampleClassLibrary.dll"); 
} 


测试 方法 信息 所 在 的 XML 文档 如 下 所 示 。 


<?xml version="1.0" encoding="utf-8" ?> 
<Tests> 
<Test className='SampleClassLibrary.SampleClass' 
methodName='TestMethod1'> 
<Argument>Running TestMethodi«/Argument» 
</Test> 
«Test className='SampleClassLibrary.SampleClass' 
methodName='TestMethod2'> 
<Parameter>Running TestMethod2</Parameter> 
<Parameter>27</Parameter> 
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</Test> 
</Tests> 


如 例 6-4 中 所 示 ，ReftLectionInvoke 使 用 XDocument 中 包含 的 信息 动态 地 调用 传递 给 它 的 


方法 。 











Convert.Changetype 方法 将 提供 的 值 从 一 个 字符 串 转 换 为 实际 类 型 。 最 





返回 值 由 MethodBase. Invoke 方法 返 
例 6-4: ReflectionInvoke 方法 





L 





I] , 


每 个 参数 的 类 型 通过 检查 MethodInfo 上 的 ParameterInfo 数据 项 来 确定 ， 然 后 通过 


bey oR 


RA, 


被 调用 方法 的 


public static void ReflectionInvoke(XDocument xdoc, string asmPath) 


{ 


from t in xdoc.Root.El 
select new 


( 


var test - 


typeName - (strin 
methodName - (str 
parameter - from 

selec 


5 


// 加 载 程序 集 
AssembLy asm = AssembLy.LoadFrom( 


foreach (var elem in test) 


{ 
// 创建 实际 类 型 
Type refLCLassType 


asm.GetT 





// 创建 此 类 型 的 一 个 实例 并 验证 
object reflObj = Activator.Cr 
if (reflObj != null) 

{ 


ements("Test") 


g)t.Attribute("className").Value, 
ing)t.Attribute("methodName").Value, 
p in t.Elements("Parameter") 

t new { arg = p.Value } 


asmPath); 


ype(elem.typeName, true, false); 


它 是 否 存 在 


eateInstance(reflClassType); 


// 验证 方法 是 否 存在 ,并 获取 MethodInfo 对 象 





MethodInfo invokedMethod = 


if (invokedMethod != null 
{ 





// 创建 动态 调用 所 需 的 
object[] arguments 
int index = 0; 


// 将 每 一 个 参数 添加 到 


reflClassType.GetMethod(elem.methodName); 
) 
参数 列表 


new object[elem.parameter.Count()]; 





列表 中 


foreach (var arg in elem.parameter) 


{ 
// 获得 参数 类 型 
Type paramType 


invokedMethod. 


// "df Aper RF 
arguments[index] = 

Convert. Chang 
index++; 


} 
// 使 用 











参数 调用 方法 








GetParameters()[index].ParameterType; 


赋值 





eType(arg.arg, paramType); 





object retObj = invokedMethod.Invoke(reflObj, arguments); 


Console.WriteLine($"\tReturned object: {retObj}"); 
Console.WriteLine($"\tReturned object: {retObj.GetType().FullName}"); 
} 
} 
} 
} 


以 下 这 些 是 动态 调用 的 方法 ， 位 于 SampleClassLibrary 程序 集中 的 SampleClass 类 型 上 。 


public bool TestMethodi(string text) 


{ 
Console.WriteLine(text) ; 
return (true); 
} 
public bool TestMethod2(string text, int n) 
{ 
Console.WriteLine(text + " invoked with {0}",n); 
return (true); 
} 


这 些 方法 的 输出 如 下 所 示 。 


Running TestMethod1 
Returned object: True 
Returned object: System.Boolean 
Running TestMethod2 invoked with 27 
Returned object: True 
Returned object: System.Boolean 


6.4.3 讨论 

反射 赋予 用 户 动态 调用 相同 程序 集 或 不 同 程 序 集中 某 一 类 型 内 的 静态 方法 和 实例 方法 的 能 
力 。 这 是 一 种 非常 强大 的 工具 ， 人 允许 用 户 代 码 在 运行 时 确定 调用 哪个 方法 。 这 一 确定 过 程 
可 基于 程序 集 名 称 、 类 型 名 称 或 方法 名 称 ， 即 使 在 以 下 这 些 并 不 需要 程序 集 名 称 的 情况 下 
也 是 如 此 : 方法 位 于 调用 代码 所 处 的 同一 个 程序 集中 ， 已 经 获得 了 Assembly 对 象 ， 或 者 获 
得 了 方法 所 在 的 类 的 Type 对 象 。 

像 往常 一 样 ， 能 力 越 大 、 责 任 越 大 。 动 态 加 载 程序 集 而 不 知道 其 来 源 (或 者 
甚至 是 在 一 个 提升 的 上 下 文中 的 合法 调用 ) 会 造成 不 需要 的 后 果 ， 所 以 要 明 
智 、 安 全 地 使 用 这 种 技术 。 




















这 种 技术 看 起 来 与 委托 类 似 ， 因 为 两 者 都 能 够 在 运行 时 动态 地 决定 调用 哪个 方法 。 总 的 来 
说 ， 委 托 要 求 用 户 知道 在 运行 时 可 能 调用 的 方法 签名 ， 而 使 用 反射 ， 用户 可 以 在 对 签名 一 
无 所 知 的 情况 下 调用 方法 ， 提 供 更 宽松 的 绑 定 。 但 是 ， 用 户 仍 需要 传递 合理 的 参数 。 使 用 
Delegate.DynamicInvoke 可 完成 更 加 动态 的 调用 ， 但 它 更 大 程度 上 是 一 个 基于 反射 的 方法 
而 不 是 传统 的 委托 调用 。 
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6.4.2 市 所 示 的 Ref lecttonInvoke 方法 包含 动态 调用 一 个 方法 所 需 的 所 有 代码 。 该 代码 首 
先 使 用 程序 集 名 加 载 程序 集 (通过 asmPath 参数 传递 )， 然 后 获得 包含 针对 要 调用 方法 的 
类 的 Type 对 象 ( 类 名 使 用 LINQ 从 Test 元 素 的 className 属性 中 获得 )， 然 后 使 用 LINQ 
从 Test 元 素 的 methodName 属性 中 重新 获得 方法 名 。 一 旦 从 Test 元 素 中 获得 了 所 有 信息 ， 
生成 一 个 Type 对 象 的 实例 ， 然 后 就 可 以 调用 这 个 生成 的 实例 上 的 指定 方法 ， 操 作 步 又 如 
下 所 示 。 


。 首先 ， 调 用 静态 Activator.CreateInstance 方法 实际 生成 局 部 变量 reflClassType 中 包 
含 的 Type 对 象 的 一 个 实例 。 方 法 返回 一 个 指向 生成 的 类 型 实例 的 对 象 引 用 ， 如 果 对 象 
不 能 生成 则 引发 一 个 异常 。 
。 人 导 该 类 的 实例 之 后 ， 通 过 调用 Type 对 象 上 的 GetMethod 获得 要 调用 方法 的 
MethodInfo Xj, 


然后 ， 将 使 用 CreateInstance 方法 生成 的 对 象 实例 作为 第 一 个 参数 传递 给 MethodInfo. 
Invoke 方法 。 该 方法 返回 一 个 包含 被 调用 方法 的 返回 值 的 对 象 。 之 后 ，InvokeMethod 返回 
该 对 象 。 传 递 给 MethodInfo. Invoke 的 第 二 个 参数 是 一 个 包含 所 有 要 传递 给 该 方法 的 参数 
的 对 象 数 组 。 该 数组 根据 XML 中 每 个 Test 元 素 节 点 下 的 Parameter 元 素数 目 进行 构建 。 
随后 会 看 到 每 个 参数 的 ParameterInfo (通过 MethodInfo.GetParameters 获得 )， 并 使 用 
Convert.ChangeType 方法 将 XML 中 的 字符 串 值 转换 为 正确 的 类 型 。 


Ref LectionInvoke 方法 最 后 显示 每 个 返回 的 对 象 值 及 其 类 型 。 注 意 到 从 被 调用 的 方法 中 返 
回 不 同 的 返回 值 不 需要 额外 的 逻辑 ， 因 为 返回 值 都 是 作为 一 个 对 象 返 回 的 ， 与 将 不 同 参数 
传递 给 被 调用 的 方法 时 不 同 。 


6.44 B84 


MSDN 文档 中 的 “Activator 类 ” “MethodInfo 类 ” “Convert.ChangeType 7j iÀ " FU 
“ParameterInfo 类 ”主题 。 


6.5 访问 局 部 变量 信息 


6.5.1 问题 
你 正在 构建 一 个 检查 代码 的 工具 ， 需 要 访问 一 个 方法 内 的 局 部 变量 。 


6.5.2 解决 方案 
使 用 MethodBody 类 上 的 LocalVariables 属性 以 返回 一 个 LocalVariableInfo 对 象 的 IList, 
其 中 每 个 对 象 描 述 了 方法 内 的 一 个 局 部 变量 。 


public static ReadOnlyCollection<LocalVariableInfo> 
GetLocalVars(string asmPath, string typeName, string methodName) 
{ 

Assembly asm = Assembly.LoadFrom(asmPath) ; 

Type asmType = asm.GetType(typeName) ; 






























































MethodInfo mi = asmType.GetMethod(methodName); 
MethodBody mb = mi.GetMethodBody(); 


System.Collections.ObjectModel.ReadOnlyCollection«LocalVariableInfo» vars = 
(System.Collections.ObjectModel.ReadOnlyCollection«LocalVariableInfo») 
mb.LocalVariables; 


























// 显示 每 个 局 部 变量 的 信息 
foreach (LocalVariableInfo lvi in vars) 


{ 
Console.WriteLine($"IsPinned: {lvi.IsPinned}"); 
Console.WriteLine($"LocalIndex: {lvi.LocalIndex}"); 
Console.WriteLine($"LocalType.Module: (lvi.LocalType.Module]"); 
Console.WriteLine($"LocalType.FullName: {Lvi.LocalType.FullName}"); 
Console.WriteLine($"ToString(): {lvi.ToString()}"); 

} 


return (vars); 


} 
GetLocalVars 方法 可 使 用 下 列 代码 进行 调用 。 


public static void TestGetLocalVars() 


( 





string file - GetProcessPath(); 


// Skf&CSharpRecipes.Reflection.GetLocalVars 
// 方法 内 的 所 有 局 部 变量 信息 
System.Collections.ObjectModel.ReadOnlyCollection«LocalVariableInfo» vars = 
GetLocalVars(file, "CSharpRecipes.ReflectionAndDynamicProgramming", 
"GetLocalVars"); 























} 
此 处 展示 的 GetProcessPath 返回 进程 可 执行 文件 的 当前 路 径 。 


private static string GetProcessPath() 

















{ 
// 修正 路 径 , 以 便 在 调试 器 中 运行 时 返回 原始 文件 
string processName = Process.GetCurrentProcess().MainModule.FileName; 
int index = processName.IndexOf("vshost", StringComparison.Ordinal); 
if (index != -1) 
{ 
string first = processName.Substring(0, index); 
int numChars = processName.Length - (index + 7); 
string second = processName.Substring(index + 7, numChars); 
processName = first + second; 
} 
return processName; 
} 


这 个 方法 的 输出 如 下 所 示 。 


IsPinned: False 
LocalIndex: 0 
LocalType.Module: CommonLanguageRuntimeLibrary 
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在 CSharpRecipes.Ref lection.GetLocalvars 方法 中 找到 的 、 用 于 每 个 局 部 变 


LocalType.FullName: System.Reflection.Assembly 

ToString(): System.Reflection.Assembly (0) 

IsPinned: False 

LocalIndex: 1 

LocalType.Module: CommonLanguageRuntimeLibrary 

LocalType.FullName: System.Type 

ToString(): System.Type (1) 

IsPinned: False 

LocalIndex: 2 

LocalType.Module: CommonLanguageRuntimeLibrary 

LocalType.FullName: System.Reflection.MethodInfo 

ToString(): System.Reflection.MethodInfo (2) 

IsPinned: False 

LocalIndex: 3 

LocalType.Module: CommonLanguageRuntimeLibrary 

LocalType.FullName: System.Reflection.MethodBody 

ToString(): System.Reflection.MethodBody (3) 

IsPinned: False 

LocalIndex: 4 

LocalType.Module: CommonLanguageRuntimeLibrary 

LocalType.FullName: System.Collections.ObjectModel.ReadOnlyCollection 1[[System. 
Reflection.LocalVariableInfo, mscorlib, Version-4.0.0.0, Culture-neutral, Public 
KeyTokenzb77a5c561934e089]] 

ToString(): System.Collections.ObjectModel.ReadOnlyCollection' 1[System.Reflectio 
n.LocalVariableInfo] (4) 

IsPinned: False 

LocalIndex: 5 

LocalType.Module: CommonLanguageRuntimeLibrary 

LocalType.FullName: System.Collections.Generic.IEnumerator 1[[System.Reflection. 
LocalVariableInfo, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b7 
7a5c561934e089]] 

ToString(): System.Collections.Generic.IEnumerator 1[System.Reflection.LocalVari 
ableInfo] (5) 

IsPinned: False 

LocalIndex: 6 

LocalType.Module: CommonLanguageRuntimeLibrary 

LocalType.FullName: System.Reflection.LocalVariableInfo 

ToString(): System.Reflection.LocalVariableInfo (6) 

IsPinned: False 

LocalIndex: 7 

LocalType.Module: CommonLanguageRuntimeLibrary 

LocalType.FullName: System.Collections.ObjectModel.ReadOnlyCollection 1[[System. 
Reflection.LocalVariableInfo, mscorlib, Version-4.0.0.0, Culture-neutral, Public 
KeyTokenzb77a5c561934e089]] 

ToString(): System.Collections.ObjectModel.ReadOnlyCollection 1[System.Reflectio 
n.LocalVariableInfo] (7) 


jain 


L 


LocalVariableInfo 对 象 将 在 vars IList 集合 中 返回 。 





6.5.3 讨论 


LocalVariables 属性 可 给 出 关于 一 个 方法 内 变量 的 大 量 信 息 ， 它 返回 一 
IList«LocalVariableInfo» 集合 。 每 个 LocalVariableInfo 对 象 都 包含 表 6-4 中 描述 的 信息 。 








的 


Ay 
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386-4; LocalVariableInfo 信 息 
IsPinned ”返回 一 个 表示 这 个 变量 引用 的 对 象 是 (true) A (false) 被 固定 在 内 存 中 的 布尔 值 。 在 非 
















































































托管 代码 中 ， 一 个 对 象 必 须 首先 被 固定 才能 被 非 托管 指针 引用 。 当 对 象 被 固定 时 ， 不 能 被 
垃圾 回收 移动 

Localindex — 返回 方法 体内 这 个 变量 的 索引 

LocalType 返回 一 个 描述 这 个 变量 类 型 的 Type 对 象 

ToString 返回 LocaLType.FuLLName、 一 个 空格 ， 然 后 是 用 括号 括 住 的 Localindex [É 


6.5.4 ”参考 


MSDN 文档 中 的 “MethodInfo 类 ”“MethodBody 类 " “ReadOnlyCollection<T> 类 " 和 
“LocalVariableInfo 类 ”主题 。 


6.6 创建 一 个 泛 型 类 型 


6.6.1 问题 
你 想 要 只 使 用 反射 API 来 生成 一 个 泛 型 类 型 。 


6.6.2 ”解决 方案 

创建 一 个 泛 型 类 型 类 似 于 创建 一 个 非 泛 型 类 型 ， 但 是 在 构建 时 需要 一 个 额外 的 步骤 创建 想 
要 使 用 的 类 型 实 参 并 且 将 这 些 类 型 实 参 绑 定 到 泛 型 类 型 的 类 型 形 参 。 为 此 ， 将 要 使 用 一 个 
添加 到 Type 类 上 的 新 方法 ， 名 为 BtndGenericParameters。 


public static void CreateDictionary() 


( 














// 获得 想 要 构造 的 类 型 

Type typeToConstruct = typeof(Dictionary<,>); 

// 获得 想 要 使 用 的 类 型 参数 

Type[] typeArguments = {typeof(int), typeof(string)}; 

// 将 类 型 参数 绑 定 到 泛 型 类 型 

Type newType = typeToConstruct.MakeGenericType(typeArguments); 


// 构造 泛 型 类 型 
Dictionary<int, string> dict = 
(Dictionary<int, string>)Activator.CreateInstance(newType) ; 


// 测试 新 构造 的 类 型 

Console.WriteLine($"Count == {dict.Count}"); 

dict.Add(1, "test1"); 

Console.WriteLine($"Count == {dict.Count}"); 
} 


测试 CreateDictionary 方法 的 代码 如 下 所 示 。 
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public static void TestCreateMultiMap() 





{ 

Assembly asm = Assembly.LoadFrom("C:\\CSCB6 " + 
"\\Code\\CSharpRecipes\\bin\\Debug\\CSharpRecipes.exe"); 

CreateDictionary(asm) ; 

} 

这 一 方法 的 输出 如 下 所 示 。 
Count == 0 
Count == 1 


6.6.3 ”讨论 
类 型 形 参 在 一 个 类 上 定义 ， 表 示 所 有 能 够 被 转换 为 Object 的 类 型 都 允许 替代 这 一 类 型 形 参 
(当然 ， 除 非 在 这 一 类 型 形 参 上 存在 使 用 where 关键 字 添 加 的 约束 )。 例 如 ， 下 列 类 有 两 个 
类 型 形 参 T 和 U。 


public class Foo<T, U> {...} 








当然 ， 你 并 非 一 定 要 使 用 T 和 U， 还 可 以 使 用 其 他 字母 甚至 是 完整 的 名 称 ， 
如 TypeParam1 和 TypeParam2。 





一 个 类 型 实 参 被 定义 为 将 要 替代 类 型 形 参 的 实际 类 型 。 在 前 面 定义 的 类 Foo 中 ， 用 户 可 以 
用 类 型 实 参 int 替代 类 型 形 参 T， 用 类 型 实 参 string 替代 类 型 形 参 U, 


BindGenericParameters 方法 允许 用 户 用 实际 类 型 实 参 替代 类 型 形 参 。 这 一 方法 接受 一 个 
Type 数组 参数 。 这 个 Type 数组 由 将 末代 泛 型 类 型 的 每 个 类 型 形 参 的 类 型 实 参 构成 。 这 些 
类 型 实 参 必须 按 它们 在 类 中 定义 的 顺序 添加 到 这 个 Type 数组 中 。 例 如 ，Foo 类 按 顺 序 定义 
了 类 型 形 参 T 和 U。 开 发 人 员 定 义 的 Type 数组 按 这 个 顺序 包含 一 个 int 类 型 和 一 个 string 
类 型 。 这 意味 着 ， 类 型 形 参 T 将 被 类 型 实 参 int 替代 ， 而 U 将 被 一 个 strin 类 型 替代 。 
BindGenericParameters 方法 将 返回 一 个 使 用 指定 类 型 实 参 的 类 型 的 Type 对 象 。 














6.6.4 ”参考 


MSDN 文档 中 的 “Type.BindaenericParameters 方法 ”主题 。 


6.7 ”使 用 dynamic 与 使 用 object 


6.7.1 问题 
尔 想 要 知道 使 用 dynamic 和 object 作为 类 型 规范 时 的 不 同 点 。 





6.7.2 解决 方案 


要 演示 dynamic Fil object 之 间 的 主要 区 别 ， 我 们 将 回顾 范例 6.4〈 即 6.4 节 ) 中 使 用 的 示 
例 类 。 那 段 代码 动态 地 加 载 SampleClass 类 型 的 一 个 实例 ， 然 后 使 用 一 个 XML 文件 和 反射 
机 制 ， 运 行 实例 上 的 某 些 操作 。 那 个 实例 是 object 类 型 。 如 果 我 们 创建 类 型 并 将 其 标记 为 
dynamic， 就 可 以 编写 代码 以 在 代码 中 直接 调用 方法 (放弃 了 前 一 示例 中 的 灵活 性 ， 但 是 使 
代码 更 简洁 )， 即 使 dynamic 对 象 实例 并 不 是 SampleClass 类 型 也 是 如 此 。 


// 加 载 程序 集 
Assembly asm = Assembly.LoadFrom(Q"SampleClassLibrary.dll"); 














// 获得 SampLeCLass 类 型 
Type refLCLassType = asm?.GetType("SampleClassLibrary.SampleClass", true, false); 


if (reflClassType != null) 
{ 





// 创建 示例 类 实例 

dynamic sampLeCLass = Activator.CreateInstance(reflClassType) ; 
Console.WriteLine($"LastMessage: {sampleClass.LastMessage}"); 
Console.WriteLine("Calling TestMethod1"); 
sampleClass.TestMethodi("Running TestMethod1"); 
Console.WriteLine($"LastMessage: {sampleClass.LastMessage}"); 
Console.WriteLine("Calling TestMethod2") ; 
sampleClass.TestMethod2("Running TestMethod2", 27); 
Console.WriteLine($"LastMessage: {sampleClass.LastMessage}"); 


} 


注意 到 我 们 可 以 直接 调用 方法 而 不 会 产生 错误 ， 即 使 对 象 实例 的 类 型 是 dynamic, ik AE 
因为 编译 器 知道 要 推迟 这 些 调 用 (LastMessage、TestMethod1、TestMethod2) 的 类 型 检 
查 直 到 运行 时 。 尽 管 对 待 dynamic 的 方式 像 对 待 object 一 样 ， 甚 至 dynamic 最 终 编译 为 
object， 但 是 它 会 告诉 编译 器 :“ 嘿 ， 放 松 些 ， 我 知道 自己 在 做 什么 ! ”， 并 允许 你 调用 编 
译 器 无 法 解析 的 方法 和 属性 。 


这 一 示例 的 输出 如 下 所 示 。 


LastMessage: Not set yet 

Calling TestMethod1 

Running TestMethod1 

LastMessage: Running TestMethod1 
Calling TestMethod2 

Running TestMethod2 invoked with 27 
LastMessage: Running TestMethod2 














X 





6.7.3 讨论 
dynamic 类 型 允许 你 绕 过 编译 时 类 型 检查 ， 并 在 运行 时 将 操作 绑 定 到 调用 站 点 。 





请 记 住 ， 如 果 访 问 了 某 个 动态 对 象 上 不 存在 的 成 员 ， 而 且 在 运行 之 前 没有 察 
觉 的 话 ， 将 会 遇 到 未 预期 的 异常 。 
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大 多 数 情况 下 ，dynamtic 的 行为 就 像 object， 延 迟 检查 是 两 者 的 主要 区 别 。 一 旦 dynamic 
类 型 上 的 操作 被 调用 ， 绑 定 的 结果 会 被 缓存 下 来 以 帮助 改善 下 次 调用 该 操作 的 性 能 。 如 果 
查看 动态 方法 的 IL, HAF] sampleClass 局 部 变量 实际 编译 成 为 了 object 类 型 。 


.locals init ([0] class [mscorlib]System.Reflection.Assembly asm, 
[1] class [mscorlib]System.Type reflClassType, 
[2] bool V 2, 
[3] object sampleClass) 


如 果 我 们 试图 在 SampleClass 上 使 用 object 代替 dynamic 进行 同样 的 操作 : 


object objSampleClass = Activator.CreateInstance(reflClassType); 
Console.WriteLine($"LastMessage: {objSampleClass.LastMessage}"); 
Console.WriteLine("Calling TestMethod1") ; 
objSampleClass.TestMethodi("Running TestMethod1"); 
Console.WriteLine($"LastMessage: {objSampleClass.LastMessage}"); 
Console.WriteLine("Calling TestMethod2"); 
objSampleClass.TestMethod2("Running TestMethod2", 27); 
Console.WriteLine($"LastMessage: {objSampleClass.LastMessage}"); 


会 得 到 以 下 编译 器 错误 。 


Error CS1061 'object' does not contain a definition for 'LastMessage' and no 
extension method 'LastMessage' accepting a first argument of type 'object' could 
be found(are you missing a using directive or an assembly reference ?) 

06 ReflectionAndDynamicProgramming.cs 482 

















Error CS1061 'object' does not contain a definition for 'TestMethod1' and no 
extension method 'TestMethodi' accepting a first argument of type 'object' could 
be found(are you missing a using directive or an assembly reference ?) 

06 ReflectionAndDynamicProgramming.cs 484 


Error CS1061  'object' does not contain a definition for 'LastMessage' and no 
extension method 'LastMessage' accepting a first argument of type 'object' could 
be found(are you missing a using directive or an assembly reference ?) 

06 ReflectionAndDynamicProgramming.cs 485 


Error CS1061  'object' does not contain a definition for 'TestMethod2' and no 
extension method 'TestMethod2' accepting a first argument of type 'object' could 
be found(are you missing a using directive or an assembly reference ?) 

06 ReflectionAndDynamicProgramming.cs 487 


Error CS1061  'object' does not contain a definition for 'LastMessage' and no 
extension method 'LastMessage' accepting a first argument of type 'object' could 


be found(are you missing a using directive or an assembly reference ?) 
06 ReflectionAndDynamicProgramming.cs 488 


6.7.4 ”参考 
MSDN 文档 中 的 “dynamic” 主 题 。 





6.8 动态 构建 对 象 


6.8.1 


问题 


你 想 要 在 运行 时 能 够 动态 构建 一 个 对 象 并 处 理 它 。 


6.8.2 


使 用 Expando0bject 创建 一 个 对 象 ， 你 可 以 将 属性 、 方 法 和 事 人 


解决 方案 











EHAA 








i 中 将 数据 绑 定 到 此 对 象 。 





F 添 加 到 此 对 象 ， 并 且 能 够 





我 们 可 以 使 用 Expando0bject 来 创建 一 个 初始 对 象 ， 以 持 有 某 人 的 Name 和 当前 Country, 
代码 如 下 所 示 。 


dynamic expando = new ExpandoObject(); 
expando.Name - "Brian"; 
expando.Country - "USA"; 


一 旦 直接 添加 了 属性 ， 我 们 还 能 够 通过 使 用 已 提供 给 你 的 AddProperty 方法 ， 以 更 动态 的 


方式 向 此 对 象 添加 属性 。 有 一 个 例子 阐明 了 你 可 能 这 样 做 的 原因 























其 他 数据 源 添加 到 此 对 象 。 下 列 代 码 将 会 添加 Langauge 属性 。 


// 将 属性 动态 添加 到 expando 
AddProperty(expando, "Language", "English"); 








， 这 个 例子 就 是 将 属性 从 


AddProperty 方法 利用 ExpandoObject 对 IDictionary<string, object> 的 支持 ， 使 我 们 能 
够 使 用 运行 时 确定 的 值 来 添加 属性 ， 代 码 如 下 所 示 。 


public static void AddProperty(ExpandoObject expando, string propertyName, 
object propertyValue) 


( 


// Expando0bject 支 持 IDictionary, 所 以 我 们 能 够 如 下 所 示 地 扩展 它 
var expandoDict = expando as IDictionary<string, object>; 
if (expandoDict.ContainsKey(propertyName) ) 


expandoDict[propertyName] = propertyValue; 


else 


i 


通过 使 用 代表 一 个 方法 调用 的 Fun<> 泛 型 类 型 ， 


expandoDict.Add(propertyName, propertyValue); 


面 的 示例 中 ， 我 们 会 将 一 个 验证 方法 添加 到 expando X122 


// 将 方法 添加 到 expando 
expando.IsValid = (Func<bool>)(() => 


// 检查 是 否 提供 了 名 称 
if(string.IsNullOrWhiteSpace(expando.Name)) 


H; 


return false; 


return true; 


还 可 以 向 ExpandoObject 添加 方法 。 在 下 
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if(!expando.IsValid()) 
{ 


} 


// 不 允许 继续 





现在 ， 我 们 还 可 以 使 用 Action<> 泛 型 类 型 定义 事件 并 将 事件 添加 到 Expando0bject。 我 
们 将 添加 两 个 事件 ，LanguageChanged 和 CountryChanged。 在 定义 eventHandler 变量 来 
保存 Action«object, EventArgs» 之 后 ， 我 们 将 添加 LanguageChanged， 还 将 直接 添加 
CountryChanged 作为 内 联 匿名 方法 。CountryChanged 监测 Country， 在 其 改变 时 以 对 应 























Tr 


Country 的 正确 Language 调用 LanguageChanged 33-4 
名 方法 ， 但 有 时 添加 一 个 对 应 的 变量 能 够 使 代码 更 清晰 。) 


// 同样 可 以 将 事件 处 理 器 添加 到 expando 对 象 
var eventHandler = 
new Action<object, EventArgs>((sender, eventArgs) => 


{ 























dynamic exp = sender as ExpandoObject; 

var langArgs = eventArgs as LanguageChangedEventArgs; 
Console.WriteLine($"Setting Language to : {langArgs?.Language}"); 
exp.Language = langArgs?.Language; 


P; 


// 添加 一 个 LanguageChanged 事 件 和 预定 义 的 事件 处 理 器 
AddEvent(expando, "LanguageChanged", eventHandler); 

















// 添加 一 个 CountryChanged 事 件 和 一 个 内 联 事件 处 理 器 
AddEvent(expando, "CountryChanged", 
new Action<object, EventArgs>((sender, eventArgs) => 




















{ 
dynamic exp = sender as ExpandoObject; 
var ctryArgs = eventArgs as CountryChangedEventArgs; 
string newLanguage = string.Empty; 
switch (ctryArgs?.Country) 
{ 
case "France": 
newLanguage = "French"; 
break; 
case "China": 
newLanguage = "Mandarin"; 
break; 
case "Spain": 
newLanguage = "Spanish"; 
break; 
} 
Console.WriteLine($"Country changed to {ctryArgs?.Country}, " + 
$'changing Language to {newLanguage}"); 
exp?.LanguageChanged(sender , 
new LanguageChangedEventArgs() { Language = newLanguage }); 
D» 




















下 列 代码 提供 了 AddEvent 方法 以 封装 将 事件 添加 到 ExpandoObject 的 细节 。 这 再 


。 (注意 ，LanguageChanged 也 是 一 个 匿 














了 ExpandoObject 对 IDictionary<string, object» 的 支持 。 








次 利用 





public static void AddEvent(ExpandoObject expando, string eventName, 
Action<object, EventArgs> handler) 


{ 
var expandoDict = expando as IDictionary<string, object>; 
if (expandoDict.ContainsKey(eventName)) 
expandoDict[eventName] - handler; 
else 
expandoDict.Add(eventName, handler); 
} 





ida, ExpandoObject 支持 INotifyPropertyChanged, XÆ NET 中 将 数据 绑 定 到 属性 的 基 
础 。 我 们 挂 接 事件 处 理 程序 ， 当 Country 属性 更 改 时 触发 CountryChanged 事件 。 


((INotifyPropertyChanged)expando).PropertyChanged += 
new PropertyChangedEventHandler((sender, ea) => 





{ 
dynamic exp = sender as dynamic; 
var pcea = ea as PropertyChangedEventArgs; 
if(pcea?.PropertyName == "Country") 
exp.CountryChanged(exp, new CountryChangedEventArgs() 
{ Country = exp.Country }); 
DH 


现在 ， 我 们 已 经 完成 了 对 象 的 构建 ， 可 以 像 下列 代 码 一 样 调用 它 来 模拟 我 们 周游 世界 的 
朋友 。 


Console.WriteLine($"expando contains: {expando.Name}, {expando.Country}, " + 
$"(expando.Language] "); 
Console.WriteLine(); 








Console.WriteLine("Changing Country to France..."); 
expando.Country = "France"; 
Console.WriteLine($"expando contains: {expando.Name}, {expando.Country}, "+ 


$"(expando.Language] "); 
Console.WriteLine(); 


Console.WriteLine("Changing Country to China..."); 

expando.Country = "China"; 

Console.WriteLine($"expando contains: {expando.Name}, {expando.Country}, "+ 
$"(expando.Language] "); 

Console.WriteLine(); 


Console.WriteLine("Changing Country to Spain..."); 
expando.Country = "Spain"; 
Console.WriteLine($"expando contains: {expando.Name}, {expando.Country}, "+ 


$"(expando.Language] "); 
Console.WriteLine(); 


此 示例 的 输出 如 下 所 示 。 


expando contains: Brian, USA, English 


Changing Country to France... 
Country changed to France, changing Language to French 
Setting Language to: French 
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expando contains: Brian, France, French 


Changing Country to China... 

Country changed to China, changing Language to Mandarin 
Setting Language to: Mandarin 

expando contains: Brian, China, Mandarin 


Changing Country to Spain... 

Country changed to Spain, changing Language to Spanish 
Setting Language to: Spanish 

expando contains: Brian, Spain, Spanish 


6.8.3 讨论 

ExpandoObject 允许 编写 比 使 用 GetProperty("Field") 的 典型 反射 代码 更 具 可 读 性 的 代码 。 
当 处 理 XML BK JSON 时 ，Expando0bject 可 用 于 快速 设置 一 个 类 型 来 编程 ， 而 非 总 是 必须 
创建 数据 传输 对 象 。 对 于 任何 使 用 WPF、MVC 或 其 他 NET 中 的 编 定 框架 的 开发 人 员 来 
说 ，Expando0bject 通过 INotifyPropertyChanged 对 数据 绑 定 的 支持 是 最 大 的 亮点 ， 它 允许 
你 像 使 用 其 他 静态 类 型 一 样 使 用 这 些 对 象 ， 而 且 是 动态 的 。 


因为 ExpandoObject 将 委托 作为 其 成 员 ， 所 以 你 可 以 将 方法 和 事件 附加 到 这 些 动态 的 类 型 ， 
同时 代码 看 起 来 像 在 处 理 一 个 静态 类 型 。 


public static void AddEvent(ExpandoObject expando, string eventName, 
Action<object, EventArgs> handler) 









































{ 
var expandoDict = expando as IDictionary<string, object>; 
if (expandoDict.ContainsKey(eventName)) 
expandoDict[eventName] - handler; 
else 
expandoDict.Add(eventName, handler); 
} 


你 可 能 想 知道 为 什么 我 们 疫 有 将 AddProperty 和 AddEvent 编写 为 扩展 方法 。 它 们 都 可 以 挂 
接 在 ExpandoObject 上 并 使 语法 更 简洁 ， 对 吧 ? 不 幸 的 是 ， 不 能 。 扩 展 方法 的 工作 方式 是 
lod Rib EE 匹配 扩展 类 的 类 。 这 意味 着 ，DLR 必须 在 运行 时 同样 知道 所 有 这 些 信 

息 (因为 ExpandoObject 由 DLR 处 理 )， 而 目前 并 不 是 类 和 方法 所 有 的 信息 都 被 编码 到 了 
调用 站 点 i. 














下 面 列 出 了 LanguageChanged 和 CountryChanged 事件 的 事件 参数 类 。 
public class LanguageChangedEventArgs : EventArgs 
: public string Language { get; set; } 
} 
public class CountryChangedEventArgs : EventArgs 
: public string Country { get; set; } 
j 





6.8.4 ”参考 


MSDN 文档 中 的 “Expando0bject 25" “Func<> 委托 ”“Action<> 委托 ”和 “INotifyProper- 
tyChanged 接口 ”主题 。 


6.9 使 对 象 可 扩展 


6.9.1 问题 
你 想 要 有 一 个 基 类 可 用 于 在 运行 时 扩展 对 象 ， 以 便 可 以 从 此 基 类 派生 出 多 个 模型 以 避免 重 
复 的 代码 。 


6.9.2 解决 方案 
使 用 从 DynamicObject 派生 的 DynamicBase<T> 类 来 创建 一 个 新 类 或 者 封装 一 个 现 有 类 。 


public class DynamicBase<T> : DynamicObject 
where T : new() 

















limi 
BED 





( 


private T _containedObject = default(T); 
[JsonExtensionData] //JSON.NET 5.0 或 更 高 版 本 
private Dictionary<string, object> _dynamicMembers = 


new Dictionary<string, object>(); 


private List<PropertyInfo> _propertyInfos = 
new List<PropertyInfo>(typeof(T).GetProperties()); 


public DynamicBase() 


{ 
} 
public DynamicBase(T containedObject) 
{ 
_containedObject = containedObject; 
} 


public override bool TryInvokeMember(InvokeMemberBinder binder, 
object[] args, out object result) 


{ 
if ( dynamicMembers.ContainsKey(binder.Name) 
&& dynamicMembers[binder.Name] is Delegate) 
{ 
result = ( dynamicMembers[binder.Name] as Delegate) .DynamicInvoke( 
args); 
return true; 
} 
return base.TryInvokeMember(binder, args, out result); 
} 


public override IEnumerable<string> GetDynamicMemberNames() => 
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_dynamicMembers.Keys; 


public override bool TryGetMember(GetMemberBinder binder, out object result) 

















{ 
result = null; 
var propertyInfo = _propertyInfos.Where(pi => 
pi.Name == binder.Name).FirstOrDefault(); 
// 确认 此 成 员 并 不 是 对 象 上 已 有 的 属性 
if (propertyInfo == null) 
// 在 额外 数据 项 集合 中 查找 它 
if ( dynamicMembers.Keys.Contains(binder.Name)) 
{ 
// 返回 动态 数据 项 
result = dynamicMembers[binder.Name]; 
return true; 
} 
} 
else 
// 从 包含 的 对 象 中 获得 它 
if ( containedObject != null) 
{ 
result = propertyInfo.GetValue( containedObject); 
return true; 
} 
} 
return base.TryGetMember(binder, out result); 
} 


public override bool TrySetMember(SetMemberBinder binder, object value) 
{ 
var propertyInfo = _propertyInfos.Where(pi => 
pi.Name == binder.Name).FirstOrDefault(); 
// 确认 此 成 员 并 不 是 对 象 上 已 有 的 属性 
if (propertyInfo == null) 








{ 
// 在 额外 数据 项 集合 中 查找 它 
if ( dynamicMembers.Keys.Contains(binder.Name)) 
// 设置 动态 数据 项 
_dynamicMembers[binder.Name] = value; 
return true; 
} 
else 
{ 
_dynamicMembers.Add(binder.Name, value); 
return true; 
} 
} 
else 
{ 














// 将 甚 置 于 包含 的 对 象 中 
if ( containedObject != null) 





propertyInfo.SetValue( containedObject, value); 
return true; 




















} 
} 
return base.TrySetMember (binder, value); 
} 
public override string ToString() 
{ 
StringBuilder builder = new StringBuilder(); 
foreach (var propInfo in _propertyInfos) 
{ 
if(_containedObject != null) 
builder .AppendFormat("{0}:{1}{2}", propInfo.Name, 
propInfo.GetValue( containedObject), Environment.NewLine) ; 
else 
builder .AppendFormat("{0}:{1}{2}", propInfo.Name, 
propInfo.GetValue(this), Environment.NewLine); 
} 
foreach (var addlItem in _dynamicMembers) 
{ 
// 排除 从 描述 中 添加 的 方法 
Type itemType = addlItem.Value.GetType(); 
Type genericType = 
itemType.IsGenericType ? 
itemType.GetGenericTypeDefinition() : null; 
if (genericType != null) 
{ 
if (genericType != typeof(Func<>) && 
genericType != typeof (Action<>) ) 
builder .AppendFormat("{0}:{1}{2}", addlItem.Key, 
addlItem.Value, Environment.NewLine) ; 
} 
else 
builder .AppendFormat("{0}:{1}{2}", addlItem.Key, addlItem.Value, 
Environment.NewLine); 
} 
return builder.ToString(); 
} 


} 


要 理解 如 何 使 用 DynamicBase<T>， 设 想 我 们 有 一 个 接收 包含 运动 员 信 息 的 JSON 序列 化 负 
载 的 Web 服务 。 我 们 目前 已 经 定义 了 包括 Name 和 Sport 属性 的 DynamicAthlete 类 。 


public class DynamicAthlete : DynamicBase«DynamicAthlete- 


( 





public string Name { get; set; } 
public string Sport { get; set; } 
} 


在 发 送 给 我 们 的 负载 中 ， 调 用 者 已 经 开始 发 送 关 于 运动 员 的 Position 的 额外 信息 。 在 遗留 
系统 集成 发 生变 化 而 所 有 系统 不 能 在 同一 时 间 都 更 新 时 ， 就 会 发 生 这 种 情况 。 对 于 我 们 的 
接收 系统 ， 我 们 不 想 丢 失 某 些 系统 正在 发 送 的 新 数据 。 我 们 使 用 dynamtc fll JSON.NET 序 
列 化 器 来 模拟 构造 ISON 负载 ，JSON.NET 可 通过 NuGet 获得 。( 谢 谢 你 ，James Newton- 
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King， 这 大 棒 了 ! ) 


// 创建 运动 员 的 一 组 信息 
// 注意 接收 信息 的 服务 并 没有 在 Athlete 对 象 上 具有 Position 属 性 


dynamic initialAthletes = new[] 











{ 

new 

{ 
Name = "Tom Brady", 
Sport = "Football", 
Position = "Quarterback" 

Je 

new 

{ 
Name = "Derek Jeter", 
Sport = "Baseball", 
Position = "Shortstop" 

} 

new 

{ 
Name = "Michael Jordan", 
Sport = "Basketball", 
Position = "Small Forward" 

}, 

new 

{ 
Name = "Lionel Messi", 
Sport = "Soccer", 
Position = "Forward" 

} 

IE 


// 使 SON 序 列 化 以 发 送 到 关于 运动 员 的 一 个 Neb 服 务 
string serializedAthletes = JsonNetSerialize(initialAthletes); 
假定 运动 员 信息 的 ISON 负载 进入 你 的 服务 并 且 被 反 序列 化 (再 次 感谢 JSON.NET)， 然 后 
我 们 将 其 反 序列 化 为 一 个 DynamicAthlete 数组 ， 代 码 如 下 所 示 。 
// 反 序 列 化 发 送 的 JSON 


var athletes = JsonNetDeserialize«DynamicAthlete[]»(serializedAthletes); 


现在 ， 每 一 个 开发 过 任何 类 型 Web 服务 的 开发 人 员 (或 者 任何 序列 化 的 开发 ， 就 此 而 论 ) 
都 知道 ， 如 果 你 没有 一 个 地 方 放置 反 序列 化 的 信息 ， 将 会 丢失 信息 或 者 导致 错误 。 那 么 既 
然 DynamicAthtLete 上 没有 声明 Position， 传 和 人 的 Position 属性 值 会 发 生 什么 呢 ? 如 果 回 
头 看 一 下 DynamicBase<T> 的 声明 (DynamicAthlete 从 其 派生 )， 将 会 看 到 一 个 内 部 的 私有 
Dictionary<string,object>， 它 被 标记 有 JsonExtensionData 特性 。 此 特性 告诉 序列 化 器 在 
何 处 存放 在 派生 对 象 中 没有 对 应 位 置 的 属性 值 。 这 太 厉 害 了 ! 我 们 的 Position 值 存储 在 这 
个 内 部 的 字典 中 ， 这 非常 棒 ， 但 我 们 如 何 访问 它 呢 ? 
[JsonExtensionData] //JSON.NET 5.0 及 以 上 


private Dictionary<string, object> _dynamicMembers = 
new Dictionary<string, object>(); 



































既然 DynamicAthlete 派生 自 DynamicBase<T>, pij DynamicBase<T> 又 是 从 DynamicObject je 
生 的 ， 我 们 可 以 将 接收 到 的 第 一 位 运动 员 赋 值 到 动态 变量 da。 一 旦 存 到 一 个 动态 变量 中 ， 
我 们 就 可 以 访问 Position, HAR EAETE DynamicAthlete 中 定义 的 属性 之 一 。 

dynamic da = athletes[0]; 

Console.WriteLine($"Position of first athlete: {da.Position}"); 


因此 ， 可 以 保留 发 送 给 我 们 的 属性 值 ， 即 使 当 部 署 服务 时 我 们 并 不 直接 了 解 它们 ， 这 是 一 
个 很 好 的 可 靠 性 特征 。 我 们 还 可 以 向 每 个 DynamicAthlete 添加 一 个 新 方法 ， 以 获取 Name 
的 大 写 形式 ， 同 时 输出 收 到 的 内 容 。 

// 检视 athletes 并 注意 到 不 仅 获 得 Position 

// 信息 ,而 且 还 可 以 添加 一 个 操作 作用 于 实体 

// 并 作为 动态 实体 的 一 部 分 调用 该 操作 


foreach(var athlete in athletes) 












































{ 
dynamic dynamicAthlete = (dynamic)athlete; 
dynamicAthlete.GetUppercaseName = 
(Func<string>)(() => 
{ 
return ((string)dynamicAthlete.Name).ToUpper(); 
}); 
Console.WriteLine($"Athlete:"); 
Console.WriteLine(athlete) ; 
Console.WriteLine($"Uppercase Name: {dynamicAthlete.GetUppercaseName()}"); 
Console.WriteLine(); 
Console.WriteLine(); 
} 





GetUppercaseName 被 添加 到 对 象 ， 然 后 被 调用 以 返回 Name 的 大 写 版 本 。 相 应 的 输出 如 下 
所 示 。 


Athlete: 

Name:Tom Brady 
Sport:Football 
Position: Quarterback 





Uppercase Name: TOM BRADY 


Athlete: 
Name:Derek Jeter 
Sport:Baseball 
Position: Shortstop 


Uppercase Name: DEREK JETER 
Athlete: 

Name:Michael Jordan 
Sport:Basketball 


Position:Small Forward 


Uppercase Name: MICHAEL JORDAN 
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Athlete: 
Name:Lionel Messi 
Sport: Soccer 
Position: Forward 


Uppercase Name: LIONEL MESSI 


我 们 已 经 定义 了 对 象 的 情况 怎么 样 呢 ? 如 何 能 够 获得 这 一 扩展 的 优势 呢 ? 我 们 看 一 下 
StaticAthlete 类 作为 一 个 例子 的 情形 。 


public class StaticAthlete 


{ 





public string Name { get; set; } 
public string Sport { get; set; } 
} 


StaticAthlete 看 起 来 与 DynamicAthlete 差不多 ， 但 它 不 从 任何 类 派生 。 


如 果 创 建 了 一 个 StaticAthlete 实例 ， 我 们 仍然 可 以 使 用 DynamicBase<T> 将 其 包装 并 获取 
相同 的 扩展 行为 ， 如 同 我 们 将 DynamicAthlete 从 DynamicBase<T> 派生 时 所 做 的 一 样 。 


// 包 装 一 个 已 有 的 athlete 
StaticAthlete staticAthlete = new StaticAthlete() 


{ 
13 








tr 





Sport = "Hockey" 


dynamic extendedAthlete = new DynamicBase<StaticAthlete>(staticAthLete) ; 
extendedAthlete.Name = "Bobby Orr"; 
extendedAthlete.Position = "Defenseman"; 
extendedAthlete.GetUppercaseName = 

(Func<string>)(() => 


{ 
return ((string)extendedAthlete.Name).ToUpper(); 


95 
Console.WriteLine($"Static Athlete (extended):"); 
Console.WriteLine(extendedAthlete); 
Console.WriteLine($"Uppercase Name: {extendedAthlete.GetUppercaseName()}"); 
Console.WriteLine(); 
Console.WriteLine(); 


你 可 以 看 到 StaticAthlete 的 输出 与 DynamicAthlete 的 输出 是 完全 相同 的 。 
Static Athlete (extended): 
Name:Bobby Orr 


Sport:Hockey 
Position: Defenseman 


Uppercase Name: BOBBY ORR 


6.9.3 ”讨论 
DynamicObject 作为 一 个 基 类 来 帮助 你 向 类 中 添加 动态 行为 。 与 ExpandoObject 不 同 ， 它 不 
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能 被 实例 化 ， 但 可 以 从 它 派 生 。 使 用 DynamicObject 可 以 重 写 许多 不 同类 型 的 操作 ， 如 属 
性 或 方法 访问 以 及 任意 二 元 、 一 元 或 类 型 转换 操作 ， 使 得 你 能 够 灵活 地 确定 类 在 运行 时 是 
如 何 反应 的 。 


我 们 在 DynamicBase<T> 中 通过 重 写 以 下 Dynamicobject 的 方法 实现 了 其 中 一 些 操作 。 


e TryInvokeMember 











a 


e GetDynamicMemberNames 
e TryGetMember 
e TrySetMember 


TryInvokeMenber 使 得 我 们 能 够 确定 当 在 对 象 上 调用 成 员 时 ， 应 该 发 生 什 么 事 。 在 
DynamicBase<T> 中 用 它 来 查看 内 部 集合 ， 如 果 有 一 个 匹配 的 数据 项 ， 就 将 其 作为 一 个 委托 
来 动态 调用 它 。 

public override bool TryInvokeMember(InvokeMemberBinder binder, 


object[] args, 
out object result) 




















{ 
if (_dynamicMembers.ContainsKey(binder.Name) && 
_dynamicMembers[binder.Name] is Delegate) 
{ 
result = ( dynamicMembers[binder.Name] as Delegate) .DynamicInvoke( 
args); 
return true; 
} 
return base. TryInvokeMember(binder, args, out result); 
} 


GetDynamicMemberNames 获取 动态 添加 的 所 有 成 员 的 集合 ， 代 码 如 下 所 示 。 


public override IEnumerable<string> GetDynamicMemberNames() 


{ 
} 


#5 f TryGetMember 以 允许 调用 方 获 取 动 态 添加 项 目的 属性 值 。 如 果 类 的 主要 属性 信息 中 
找 不 到 它 ， 就 在 包含 动态 成 员 的 内 部 字典 中 查找 ， 并 从 那里 返回 它 ， 代 码 如 下 所 示 。 


public override bool TryGetMember(GetMemberBinder binder, out object result) 


( 


return  dynamicMembers.Keys; 


























result - null; 

var propertyInfo = propertyInfos.Where(pi => 
pi.Name -- binder.Name).FirstOrDefault(); 

// 确认 此 成 员 并 不 是 对 象 上 的 属性 

if (propertyInfo == null) 

{ 





// 在 额外 的 数据 项 集合 中 查找 它 


if (_dynamicMembers.Keys.Contains(binder .Name) ) 


{ 
// 返回 动态 数据 项 


result = _dynamicMembers[binder .Name]; 
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return true; 








} 
} 
else 
// 从 包含 的 对 象 中 获得 属性 
if ( containedObject != null) 
{ 
result = propertyInfo.GetValue( containedObject); 
return true; 
} 
} 


return base. TryGetMember(binder, out result); 
} 
TrySetMember 的 重 写 处 理 了 属性 值 的 设置 操作 。 同 上 次 一 样 ， 先 查看 类 型 化 的 对 象 ， 然 后 
到 动态 字典 中 查找 在 哪里 存储 值 ， 代 码 如 下 所 示 。 


public override bool TrySetMember(SetMemberBinder binder, object value) 


{ 























var propertyInfo = _propertyInfos.Where(pi => 
pi.Name == binder.Name).FirstOrDefault(); 

// 确认 此 成 员 并 不 是 对 象 上 的 属性 

if (propertyInfo == null) 








// 在 额外 的 数据 项 集合 中 查找 它 

if ( dynamicMembers.Keys.Contains(binder.Name)) 

{ 
// 设置 动态 数据 项 
_dynamicMembers[binder.Name] = value; 
return true; 

} 

else 

{ 
_dynamicMembers.Add(binder.Name, value); 
return true; 

} 

} 


else 


pay 


// 设置 到 包含 的 对 象 中 
if ( containedObject != null) 


{ 





propertyInfo.SetValue( containedObject, value); 
return true; 


j 
} 


return base.TrySetMember (binder, value); 
} 
我 们 也 重 写 了 ToString， 以 便 能 获得 要 在 字符 串 中 描述 的 类 的 所 有 属性 (静态 和 动态 )， 
代码 如 下 所 示 。 


public override string ToString() 


{ 
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StringBuilder builder = new StringBuilder(); 
foreach (var propInfo in _propertyInfos) 
{ 
if( containedObject != null) 
builder .AppendFormat('"{0}:{1}{2}", propInfo.Name, 
propInfo.GetValue( containedObject), Environment.NewLine) ; 
else 
builder .AppendFormat('"{0}:{1}{2}", propInfo.Name, 
propInfo.GetValue(this), Environment.NewLine) ; 
} 


foreach (var addlItem in _dynamicMembers) 


{ 











// 排除 描述 中 添加 进来 的 方法 
Type itemType = addlItem.Value.GetType(); 
Type genericType = 
itemType.IsGenericType ? itemType.GetGenericTypeDefinition() : null; 
if (genericType != null) 
{ 





if (genericType != typeof(Func<>) && 
genericType != typeof (Action<>) ) 
builder .AppendFormat("{0}:{1}{2}", addlItem.Key, addlItem.Value, 
Environment.NewLine) ; 
} 
else 
builder .AppendFormat('"{0}:{1}{2}", addlItem.Key, addlItem.Value, 
Environment.NewLine) ; 
} 


return builder.ToString(); 


} 
RAT — rinde, MOESA ARE UGAS TT EA, Be Je 0 93673 ids Dr LH HIT BRE 
的 情况 。 这 使 得 我 们 能 够 得 到 所 有 属性 的 描述 ， 如 下 所 示 。 


Name:Bobby Orr 
Sport:Hockey 
Position:Defenseman 


可 以 看 到 ，Dynamicobject 给 予 了 你 尽 你 所 想 地 去 扩展 对 象 所 需 的 所 有 能 








6.9.4 参考 


MSDN 文档 中 的 “Dynamicobject 类 ”主题 。 
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正则 表达 式 





7.0 简介 


NET Framework 类 库 (FCL) 包括 System.Text.RegularExpressions 命名 空间 ， 它 专用 于 
创建 、 执 行 用 于 字符 串 的 正则 表达 式 ， 并 获得 其 执行 结果 。 
正则 表达 式 采用 模式 形式 ， 模 式 可 以 与 字符 串 内 的 0 个 、1 个 或 多 个 字符 匹配 。 最 简单 的 
一 些 模式 是 非常 易学 的 ， 例 如 .* (匹配 除 换行 符 外 的 任何 内 容 ) 和 [A-Za-z] (匹配 任何 字 
符 )， 但 是 更 高 级 的 模式 学 习 起 来 会 比较 困难 ， 要 正确 地 实现 它们 甚至 会 更 困难 。 学 习 和 
里 解 正则 表达 式 可 能 需要 花费 相当 多 的 时 间 和 精力 ， 但 是 非常 值得 。 

Michael Fitzgeraldr 所 著 的 《学 习 正 则 表达 式 》 与 Jan Goyvaerts 和 Steven 


Levithan 合 著 的 《正则 表达 式 经 典 实例 》 可 以 帮助 你 学 习 和 扩展 对 正则 表达 
式 的 理解 。 这 两 本 英文 原 书 都 是 由 O'Reilly 出 版 的 。 



































正则 表达 式 模 式 可 以 具有 简单 的 形式 (比如 一 个 单词 或 字符 ) 或 者 复杂 得 多 的 模式 。 更 复 
杂 的 模式 可 以 识别 和 匹配 很 多 内 容 ， 例 如 ， 日 期 中 的 年 份 、ASP 页 面 中 的 所 有 «SCRIPT» 标 
签 、 句 子 中 的 短语 (根据 每 次 使 用 区 分 它们 )。.NET 正则 表达 式 提供 了 一 种 非常 灵活 、 强 
大 的 方式 来 执行 许多 任务 ， 例 如 ， 识 别 文本 、 替 换 字符 串 内 的 文本 、 基 于 一 个 或 多 个 复杂 
的 分 隔 符 把 文本 分 割 成 单独 的 部 分 。 

尽管 正则 表达 式 模 式 很 复杂 ， 但 是 FCL 中 的 正则 表达 式 类 很 易于 在 应 用 程序 中 使 用 。 执 行 
一 个 正则 表达 式 包 括 以 下 步骤 。 


(1) 创建 Regex 对 象 的 一 个 实例 ， 它 包含 正则 表达 式 模 式 以 及 用 于 执行 该 模式 的 任何 选项 。 
(2) 如 果 只 需要 第 一 个 找到 的 匹配 ， 可 以 通过 调用 Match 实例 方法 ， 获 取 指 向 Match 对 象 的 
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实例 引用 。 如 果 想 要 的 不 仅仅 是 第 一 个 找到 的 匹配 ， 可 以 通过 调用 Mathches 实例 方法 ， 
获取 指向 MatchesCollection 对 象 的 实例 引用 。 不 过 ， 如 果 只 想 知道 输入 字符 串 是 否 是 
一 个 匹配 ， 并 且 不 需要 关于 匹配 的 额外 细节 ， 则 可 使 用 Regex. IsMatch 方法 。 

(3) 如 果 调 用 Matches 方法 获取 一 个 MatchCollection 对 象 ， 可 使 用 foreach 循环 遍历 
MatchCoLtLection。 每 次 友 代 都 允许 访问 正则 表达 式 产生 的 每 一 个 Match 对 象 。 


7.1 从 MatchCollection 中 提取 组 




















7.1.1 问题 
你 有 一 个 正则 表达 式 ， 其 中 包含 一 个 或 多 个 命名 组 (也 被 称 为 命名 捕获 组 )， 如 下 所 示 。 
\\\\(?<TheServer>\w*)\\(?<TheService>\w*)\\ 


其 中 命名 组 TheServer 将 匹配 UNC 字符 串 内 的 任何 服务 器 名 称 ，TheService 将 匹配 UNC 
字符 串 内 的 任何 服务 名 称 。 

















该 模式 与 UNCW 格式 不 匹配 。 








需要 把 这 个 正则 表达 式 返 回 的 组 存储 在 一 个 通过 键 访 问 的 集合 (比如 Dictionary<string, 
Group») 中 ， 其 中 的 键 是 组 名 称 。 


7.1.2 解决 方案 
例 7-1 所 示 的 ExtractGroupings 方法 获得 以 匹配 的 组 名 称 为 键 的 一 组 Group 对 象 。 


例 7-1: ExtractGroupings 方法 
using System; 
using System.Collections; 
using System.Collections.Generics; 
using System. Text.RegularExpressions; 


public static List<Dictionary<string, Group>> ExtractGroupings(string source 
string matchPattern, 
bool wantInitialMatch) 


List<Dictionary<string, Group>> keyedMatches = 
new List<Dictionary<string, Group>>(); 

int startingElement = 1; 

if (wantInitialMatch) 

{ 


} 


startingElement = 0; 


Regex RE = new Regex(matchPattern, RegexOptions.Multiline); 
MatchCollection theMatches = RE.Matches(source); 
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j 


foreach(Match m in theMatches) 




















{ 
Dictionary<string, Group> groupings = new Dictionary<string, Group>(); 
for (int counter = startingElement; counter < m.Groups.Count; counter++) 
{ 
// 如 果 只 是 直接 返回 MatchCoLLection， 
// GroupNameFromNumber 方 法 将 不 可 用 
groupings.Add(RE.GroupNameFromNumber (counter), m.Groups[counter]) ; 
} 
keyedMatches .Add(groupings); 
} 


return (keyedMatches); 


可 以 用 下 列 方式 使 用 ExtractGroupings 方法 ， 提 取 命 名 组 并 按 名 称 组 织 它 们 。 


public static void TestExtractGroupings() 


{ 


} 


XP UU EC PE Be 





string source = @"Path = ""\\MyServer\MyService\MyPath; 
\\MyServer2\MyService2\MyPath2\"""; 
string matchPattern = @"\\\\(2?<TheServer>\w*)\\(?<TheService>\w*)\\"; 


foreach (Dictionary<string, Group> grouping in 
ExtractGroupings(source, matchPattern, true)) 
{ 
foreach (KeyValuePair<string, Group> kvp in grouping) 
Console.WriteLine($"Key/Value = {kvp.Key} / {kvp.Value}"); 
Console.WriteLine(""); 











B 


一 个 source 字符 串 并 在 matchPattern 变量 中 创建 一 个 正则 表达 式 模 














X. FÉ 


i 突出 显示 了 这 个 正则 表达 式 中 的 两 个 分 组 。 


string matchPattern = @"\\\\(?<TheServer>\w*)\\(?<TheService>\w*)\\"; 


xx p 








HAY 4 PRA TheServer 和 TheService。 可 以 通过 这 些 组 名 称 访问 与 其 中 任何 一 个 分 


组 匹配 的 文本 。 


将 source 和 matchPattern 变量 以 及 一 个 布尔 值 传 入 ExtractGroupings 方法 中 ， 稍 后 将 讨 
论 这 个 布尔 值 。 该 方法 返回 一 个 包含 Dictionary<string, Group> 对 人 象 的 List<T >。 这 些 
Dictionary<string, Group» 对 象 包含 正则 表达 式 中 每 个 命名 组 的 匹配 ， 并 以 它们 的 组 名 称 





为 键 。 











测试 方法 TestExtractGroupings 返回 如 下 内 容 。 


Key / Value = 0 / \\MyServer\MyService\ 
Key / Value = TheService / MyService 
Key / Value = TheServer / MyServer 


Key / Value = 0 / \\MyServer2\MyService2\ 
Key / Value = TheService / MyService2 
Key / Value = TheServer / MyServer2 
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如 有 果 把 ExtractGroupings 方法 的 最 后 一 个 参数 修改 为 false， 将 产生 下 面 的 输出 。 


Key / Value = TheService / MyService 
Key / Value = TheServer / MyServer 
Key / Value = TheService / MyService2 
Key / Value = TheServer / MyServer2 








这 两 个 输出 之 间 的 唯一 区 别 是 ， 当 把 ExtractGroupings 的 最 后 一 个 参数 改 为 false 时 不 会 
显示 第 一 个 分 组 。 第 一 个 分 组 总 是 正则 表达 式 的 完全 匹配 。 


7.1.3 讨论 
可 以 用 两 种 方式 之 一 定义 正则 表达 内 的 组 。 第 一 种 方式 是 ， 用 圆 括号 括 住 你 希望 定义 为 分 
组 的 子 模 式 。 这 种 分 组 类 型 有 时 被 称 为 未 命名 的 〈unnamed)。 之 后 可 以 轻松 地 从 运行 正则 
表达 式 返 回 的 每 个 Match 对 象 中 的 最 终 文本 中 提取 这 些 分 组 。 可 以 像 下 面 这 样 修改 用 于 本 
范例 的 正则 表达 式 ， 以 使 用 简单 的 未 命名 组 。 
string matchPattern = @"\\\\(\Ww*)\\(Ww*)\\"; 
在 运行 正则 表达 式 后 ， 可 以 使 用 以 1 开始 的 整数 值 访问 这 些 组 
在 正则 表达 式 内 定义 组 的 第 二 种 方式 是 使 用 一 个 或 多 个 命名 组 。 定 义 命名 组 的 方式 如 下 : 
使 用 以 下 语法 ， 用 圆 括号 括 住 你 希望 定义 为 分 组 的 子 模式 ， 并 给 每 个 分 组 添加 名 称 。 
(?<Name>\w*) 


此 语法 的 Name 部 分 是 为 这 个 组 指定 的 名 称 。 在 执行 这 个 正则 表达 式 之 后 ， 可 以 通过 名 称 
Name 访问 该 组 。 


为 了 访问 每 个 组 ， 首 先 必 须 使 用 一 个 循环 来 运 代 MatchCollection 中 的 每 个 Match 对 象 。 
对 于 每 个 Match 对 象 ， 可 以 使 用 以 下 未 命名 的 语法 访问 GroupCollection 的 索引 器 


string group1 = m.Groups[1].Value; 
string group2 = m.Groups[2].Value; 
也 可 以 使 用 下 面 命名 组 的 语法 访问 它 ， 其 中 m 是 Match HR. 


string group1 = m.Groups["Group1_Name"].Value; 
string group2 = m.Groups["Group2 Name"].Value; 


如 果 使 用 Match 方法 返回 单个 Match 对 象 而 不 是 返回 MatchCollection, ， 则 可 使 用 下 面 的 语 
法 访问 每 个 组 : 
// 未 命名 组 的 语法 


string group1 = theMatch.Groups[1].Value; 
string group2 = theMatch.Groups[2].Value; 


/ 命名 组 的 语法 
string groupi 
string group2 


其 中 theMatch 是 Match 方法 返回 的 Match 对 象 。 


































































































theMatch.Groups["Group1_Name"].Value; 
theMatch.Groups["Group2_Name"].Value; 
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7.1.4 参考 


MSDN 文档 中 的 “.NET Framework 正则 表达 式 ” 和 “Dictionary 类 ”主题 


7.2 验证 正则 表达 式 的 语法 


7.2.4 问题 
你 通过 代码 或 者 基于 月 











日 户 输入 动态 构建 了 一 个 正则 表达 式 。 在 实际 使 用 它 之 前 ， 你 需要 测 


试 这 个 正则 表达 式 语 法 的 有 效 性 。 


7.2.2 解决 方案 
使 用 例 7-2 中 所 示 的 VerifyRegEx 方法 ， 测 试 正则 表达 式 语 法 的 有 效 性 。 
例 7-2: VerifyRegEx 方法 


using System; 





using System. Text.RegularExpressions; 


public static bool VerifyRegEx(string testPattern) 


{ 
bool isValid 


= true; 


if ((testPattern?.Length ?? 0) > 0) 


{ 
try 


( 


Regex.Match("", testPattern); 


catch (ArgumentException) 


// 坏 模 式 : 语 法 错误 
isValid = false; 


j 
j 


else 


// 坏 模式 :模式 为 hull 或 空 字符 





LT 


isValid - false; 


j 


return (isValid); 


j 


要 使 用 这 个 方法 ， 可 以 把 希望 验证 的 正则 表达 式 传递 给 它 ， 代 码 如 下 所 示 。 


public static void TestUserInputRegEx(string regEx) 


{ 


if (VerifyRegEx(regEx)) 
Console.WriteLine("This is a valid regular expression."); 


else 


Console.WriteLine("This is not a valid regular expression."); 





7.2.8 讨论 

VerifyRegEx 方法 调用 静态 方法 Regex.Match， 这 一 静态 方法 用 于 直接 对 字符 串 运 行 正 则 
表达 式 模 式 。 静 态 方法 RegEx.Match 返回 一 个 Match 对 象 。 通 过 使 用 该 静态 方法 对 字符 
串 (在 本 示例 中 是 一 个 空 字符 串 ) 运行 正则 表达 式 ， 可 以 通过 监视 引发 的 异常 来 确定 
正则 表达 式 是 否 有 效 。 如 果 正 则 表达 式 的 语法 不 正确 ，Regex.Match 方法 将 会 引发 一 个 
ArgumentException。 这 个 异常 的 Message 属性 包含 正则 表达 式 运行 失败 的 原因 ，ParamName 
属性 则 包含 传递 给 Match 方法 的 正则 表达 式 。 这 两 个 属性 都 是 只 读 的 。 


在 利用 静态 方法 Match 测试 正则 表达 式 之 前 ，VerifyRegEx 方法 先 测试 正则 表达 式 是 否 
为 null 或 者 为 空 。 当 把 值 为 null 的 正则 表达 式 字 符 串 传人 Match 方法 时 ， 它 会 引发 一 个 
ArgumentNullException。 男 一 方面 ， 如 果 把 空 的 正则 表达 式 传 入 Match 方法 ， 将 不 会 引发 
异常 〈 只 要 同时 把 一 个 有 效 的 字符 串 传 递 给 了 Match 方法 的 第 一 个 参数 )。 

虽然 这 个 范例 可 以 验证 正则 表达 式 语法 是 否 正确 ， 但 它 不 会 查找 写 得 很 糟糕 的 表达 式 。 精 
糕 正则 表达 式 的 一 个 常见 情况 是 ， 表 达 式 依赖 回 济 功 能 。 回 济 会 导致 正则 表达 式 需 要 以 指 
数 倍增 的 时 间 才 能 完成 ， 使 得 看 起 来 好 像 执 行 正则 表达 式 的 代码 不 动 了 。 





一 、 














关于 正则 表达 式 回 湖 的 详细 说 明 ， 可 参阅 MSDN 文档 中 的 “正则 表达 式 中 的 
lw” EW, ， 该 主题 位 于 “.NET Framework 正则 表达 式 ” 父 主题 之 下 。 














在 正则 表达 式 使 用 回调 的 情况 下 ， 建 议 你 使 用 超时 值 来 限制 一 个 正则 表达 式 必 须 完 成 的 时 
间 。 使 用 以 下 正则 表达 式 构造 函数 。 


Regex (String, RegexOptions, TimeSpan) 


其 中 TimeSpan 是 允许 正则 表达 式 执行 的 时 间 长 度 。 


Regex regex = new RegEx(bkTrkPattern, RegexOptions.None, 
TimeSpan.FromMilliseconds(1000)); 


然后 ， 可 以 在 一 个 try-catch 语句 块 中 执行 正则 表达 式 ， 使 用 RegexMatchTimeoutException 
来 捕获 一 个 需要 非常 长 时 间 执 行 的 糟糕 正则 表达 式 。 


7.3 增强 基本 的 字符 串 蔡 换 函 数 


7.3.1 问题 
你 需要 用 一 个 新 字符 串 替换 目录 字符 串 内 的 字符 模式 。 不 过 ， 在 此 例 中 ， 每 一 次 替换 操作 
都 有 一 组 必须 满足 的 独特 条 件 以 允许 执行 替换 。 


7.3.2 解决 方案 


使 用 例 7-3 中 所 示 的 重 载 Replace 实例 方法 ， 它 接受 一 个 MatchEvaluator 委托 以 及 其 他 参 
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$t, MatchEvaluator 委托 是 一 个 回调 方法 ， 它 重 写 了 Replace 方法 的 默认 行为 。 
例 7-3: 接受 一 个 MatchEvaluator 委托 的 重 载 Replace 方法 


using System; 
using System. Text.RegularExpressions; 





public static string MatchHandler(Match theMatch) 




















{ 
// 处 理 所 有 ControLID_ 记 录 
if (theMatch.Value.StartsWith("ControlID ", StringComparison.Ordinal)) 
{ 
long controlValue = 0; 
// 获得 Top 属 性 的 数值 
Match topAttributeMatch = Regex.Match(theMatch.Value, "Top=([-]*\\d*)"); 
if (topAttributeMatch. Success) 
{ 
if (topAttributeMatch.Groups[1].Value.Trim().Equals("")) 
{ 
// 如 果 为 空 ,设置 为 0 
return (theMatch.Value.Replace( 
topAttributeMatch.Groups[0].Value.Trim(), 
"Topz0")); 
} 
else if (topAttributeMatch.Groups[1].Value.Trim().StartsWith("-" 
, StringComparison.Ordinal)) 
{ 
// 如 果 只 有 一 个 负 号 (语法 错误 ) ,设置 为 9 
return (theMatch.VaLue.RepLace( 
topAttributeMatch.Groups[0].Value.Trim(), "Top=0")); 
} 
else 
{ 
// 获得 了 一 个 有 效 的 数字 
// 将 匹配 的 字符 串 转换 为 数字 
controlValue = long.Parse(topAttributeMatch.Groups[1].Value, 
System.Globalization.NumberStyles.Any); 
// 如 果 Top 属 性 超出 了 指定 的 范围 
// 将 其 设置 为 0 
if (controlValue < 0 || controlValue > 5000) 
{ 
return (theMatch.Value.Replace( 
topAttributeMatch.Groups[0].Value.Trim(), 
"Topz0")); 
} 
} 
} 
} 
return (theMatch.Value); 
} 


Replace 方法 的 回调 方法 如 下 所 示 。 


public static void ComplexReplace(string matchPattern, string source) 


{ 
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MatchEvaluator replaceCallback = new MatchEvaluator(MatchHandler); 
Regex RE = new Regex(matchPattern, RegexOptions.Multiline); 
string newString - RE.Replace(source, replaceCallback); 


Console.WriteLine($"Replaced String = {newString}"); 


} 


为 了 将 这 个 回调 方法 与 Replace 静态 方法 结合 使 用 ， 可 以 修改 前 面 的 ComplexReplace 方 
法 ， 如 下 所 示 。 


public void ComplexReplace(string matchPattern, string source) 














{ 
MatchEvaluator replaceCallback = new MatchEvaluator(MatchHandler); 
string newString - Regex.Replace(source, matchPattern, replaceCallback); 
Console.WriteLine("Replaced String = " + newString); 

} 


其 中 source 是 要 对 其 运行 替换 操作 的 原始 字符 串 ，matchPattern 是 source 字符 串 中 要 匹 
配 的 正则 表达 式 模式 。 
如 果 通 过 以 下 代码 调用 ComplexReplace 方法 : 


public static void TestComplexReplace() 


( 








string matchPattern - "(ControlID .*)"; 

string source = @"WindowID=Main 

ControlID_TextBox1 Top=-100 Left=0 Text=BLANK 

ControlID Labeli Top=9999990 Left=0 Caption-Enter Name Here 
ControlID Label2 Top= Left-0 Caption=Enter Name Here"; 


ComplexReplace(matchPattern, source); 


) 
将 只 会 把 ControlID_* 行 的 Top 属性 从 它们 的 原始 值 更 改 为 9。 
如 果 ControlID_* 行 的 Top 属 值 性 小 于 0 或 大 于 5000， 这 个 替换 操作 的 结果 将 把 该 属性 值 
更 改 为 9。 包含 Top 属性 的 任何 其 他 标签 都 将 保持 不 变 。 下 面 三 行 source 字符 串 将 从 : 


ControLID_TextBox1 Top=-100 Left=0 Text=BLANK 
ControlID Labeli Top=9999990 Left=0 Caption=Enter Name Here 
ControlID Label2 Top= Left=0 Caption-Enter Name Here"; 


更 改 为 : 


ControlID TextBox1 Top=0 Left=0 Text=BLANK 
ControlID_Label1 Top=0 Left-0 Caption=Enter Name Here 
ControlID Label2 Top-0 Left=0 Caption=Enter Name Here"; 

















7.89.8 讨论 
在 将 MatchEvaluator 委托 作为 参数 提供 给 Regex 类 的 Replace 方法 时 将 自动 调用 它 ， 人 允许 
对 符合 正则 表达 式 模式 的 每 个 字符 串 执行 自 定义 替 换 。 


如 果 当 前 Match 对 象 操 作 的 ControLID_* 行 的 Top 属性 超出 了 指定 的 范围 ，MatchHandler 
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回调 方法 内 的 代码 将 会 返回 修改 过 的 新 字符 串 。 否 则 ， 就 会 不 加 修改 地 返回 当前 匹配 的 字 
符 串 。 这 一 特性 允许 重 写 默认 的 Replace 功能 ， 只 替换 source 字符 串 中 满足 某 种 条 件 的 那 
一 部 分 。 这 个 回调 方法 内 的 代码 将 让 你 理解 可 以 使 用 这 种 替换 技术 完成 什么 任务 。 


为 了 使 用 这 个 回调 方法 ， 需 要 采用 一 种 方式 从 ComplexReplace 方法 内 调用 它 。 首 
先 ， 创 建 一 个 System.Text.ReguLarExpresstions.MatchEvaLuator 类 型 的 变量 。 该 变量 
(replaceCallback) 是 用 于 调用 MatchHandler 方法 的 委托 。 


MatchEvaluator replaceCallback = new MatchEvaluator(MatchHandler); 


最 后 ， 将 MatchEvaluator 委托 的 引用 作为 参数 传人 Replace 方法 调用 ， 代 码 如 下 所 示 。 


string newString = Regex.Replace(source, matchPattern, replaceCallback); 


7.3.4 ”参考 
MSDN 文档 中 的 “.NET Framework 正则 表达 式 ” 主 题 。 


7.4 实现 一 个 更 好 的 分 词 器 


7.4.1 问题 


你 需要 一 个 分 词 器 (tokenizer), ， 也 被 称 为 词法 分 析 器 (lexer) ， 它 可 以 基于 一 组 明确 定义 
的 字符 来 分 割 字 符 串 。 


7.4.2 解决 方案 

使 用 Regex 类 的 Split 方法 ， 可 以 创建 正则 表达 式 来 指示 你 有 兴趣 收集 的 标记 或 者 分 隔 
符 的 类 型 。 这 种 技术 特别 适合 方程 式 ， 因 为 方程 式 的 标记 是 明确 定义 的 ， 如 下 面 的 代码 
所 示 。 


using System; 
using System. Text.RegularExpressions; 












































public static string[] Tokenize(string equation) 
{ 
Regex re = new Regex(@"([\+\-\*\(\)\A\\])")s 


return (re.Split(equation) ); 


} 
上 述 代码 将 依据 Regex 构造 国 数 中 指定 的 正则 表达 式 分 割 一 个 字符 串 。 换 名 说 ， 将 基于 
分 隔 符 +、-、*、(、)、^ 和 和 来 分 割 传人 Tokenize 方法 中 的 字符 串 。 下 面 的 方法 将 调用 
Tokenize 方法 来 标记 方程 式 (y - 3)*(3111*x^21 + x + 320), 


public static void TestTokenize() 


{ 











foreach(string token in Tokenize("(y - 3)*(3111*x^21 + x + 320)")) 
Console.WriteLine("String token = " + token.Trim()); 
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这 将 显示 以 下 输出 。 


string token 
String token 
String token 
String token 
String token 
String token 
String token 
String token 
String token 
String token 
String token 
String token 
String token 
String token 
String token 
String token 
String token 
String token 
String token 


注意 每 个 单独 的 运算 符 、 圆 括号 和 数字 都 被 分 解 成 它 自己 单独 的 标记 。 


7.4.3 讨论 
在 现实 的 项 目 中 ， 并 不 是 总 能 够 控制 代码 的 输入 集 。 通 过 利用 正则 表达 式 ， 可 以 采取 原始 
的 分 词 器 并 使 之 足够 灵活 ， 以 便 将 其 应 用 于 多 种 类 型 和 样式 的 输入 。 


这 里 使 用 的 关键 方法 是 Regex 类 的 Split 实例 方法 。 该 方法 的 返回 值 是 一 个 字符 串 数组 ， 
其 中 的 元 素 包 括 source 字符 串 〈 本 列 中 是 equation) 的 每 个 单独 的 标记 。 


注意 静态 方法 Split 允许 使 用 RegexOptions 枚 举 值 ， 而 实例 方法 允许 定义 起 始 位 置 和 出 现 
的 最 大 匹配 数量 。 这 可 能 有 助 于 你 选择 静态 方法 或 实例 方法 。 


7.4.4 参考 


MSDN 文档 中 的 “NET Framework 正则 表达 式 ” 主 题 。 


7.5 返回 匹配 所 在 的 整 行内 容 


7.5.1 问题 
你 有 一 个 包含 多 行内 容 的 字符 串 或 文 但 
这 一 整 行 ， 而 不 仅仅 是 匹配 的 文本 。 


7.5.2 ”解决 方案 


使 用 StreamReader .ReadLine 方法 获得 对 其 运行 正则 表达 式 的 文件 中 的 每 一 行 ， 如 例 7-4 


ren 


puts 
um 
un 


[uy 
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当 在 一 行 上 找到 特写 的 字符 模式 时 ， 你 希望 返回 
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所 示 。 
例 7-4: 返回 匹配 所 在 的 整 行内 容 


public static List<string> GetLines(string source, string pattern, bool isFileName) 


{ 





List<string> matchedLines = new List<string>(); 





// 如 果 这 是 一 个 文件 ,获得 整个 文件 的 文本 
if (isFileName) 
{ 
using (FileStream FS = new FileStream(source, FileMode.Open, 
FileAccess.Read, FileShare.Read) ) 
{ 
using (StreamReader SR = new StreamReader(FS)) 
{ 
Regex RE = new Regex(pattern, RegexOptions.Multiline); 
string text = ""; 
while (text != null) 
{ 
text = SR.ReadLine(); 
if (text != null) 
{ 








// 对 字符 串 中 的 每 一 行 运行 正则 于 
if (RE.IsMatch(text)) 


达 式 


5H 


// 如 果 找 到 一 个 匹配 ,获得 整 行 
matchedLines.Add(text); 


// 在 整个 字符 串 上 运行 一 次 正则 表达 式 
Regex RE = new Regex(pattern, RegexOptions.Multiline) ; 
MatchCollection theMatches = RE.Matches(source); 








// 使 用 这 些 变量 记 住 添加 到 matchedLines 的 最 后 一 行 
// 以 便 不 会 添加 重复 的 行 

int lastLineStartPos = -1; 

int lastLineEndPos = -1; 











// 获得 每 个 匹配 所 在 的 行 
foreach (Match m in theMatches) 


( 


int lineStartPos = GetBeginningOfLine(source, m.Index); 
int lineEndPos = GetEndOfline(source, (m.Index + m.Length - 1)); 


// 如 果 这 不 是 一 个 重复 行 ,添加 它 
if (lastLineStartPos != lineStartPos && 
lastLineEndPos !- lineEndPos) 


( 


string line - source.Substring(lineStartPos, 





lineEndPos - lineStartPos); 
matchedLines.Add(line); 


// 重 置 行 位 置 
lastLineStartPos = lineStartPos; 
lastLineEndPos - lineEndPos; 


j 
} 


return (matchedLines); 


} 


public static int GetBeginningOfLine(string text, int startPointOfMatch) 


{ 
if (startPointOfMatch > 0) 


{ 
} 


--startPointOfMatch; 


if (startPointOfMatch »- 0 && startPointOfMatch « text?.Length) 


// 向 左 移动 直到 找到 第 一 个 \n 字 符 


for (int index = startPointOfMatch; index >= 0; index--) 


if (text?[index] == '\n') 
{ 


return (index + 1); 


} 


return (0); 


} 


return (startPointOfMatch); 


} 


public static int GetEndOfLine(string text, int endPointOfMatch) 


{ 
if (endPointOfMatch >= 0 && endPointOfMatch < text?.Length) 


{ 

// 向 右 移动 直到 找到 第 一 个 \n 字 符 
for (int index = endPointOfMatch; index < text.Length; index++) 
{ 

if (text?[index] == '\n') 

{ 

return (index); 

} 
} 
return (text.Length); 

} 


return (endPointOfMatch); 
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MAID s MAN TAMA ASC AE TF EB ALF GetLines 方法 。 


public static void TestGetLine() 


{ 


= 

















// 获得 文件 TestFitLe.txt 中 的 每 一 行 并 作为 单独 的 字符 串 
Console.WriteLine(); 
List<string> lines = GetLines(@"C:\TestFile.txt", "Line", true); 
foreach (string s in lines) 

Console.WriteLine($"MatchedLine: {s}"); 








// 获得 给 定 字符 串 是 匹配 文本 Line 的 所 有 行 
Console.WriteLine(); 
lines = GetLines("Line1\r\nLine2\r\nLine3\nLine4", "Line", false); 
foreach (string s in lines) 
Console.WriteLine($"MatchedLine: {s}"); 


7.5.8 讨论 
GetLines 方法 接受 下 面 三 个 参数 。 
e source 
其 中 查找 模式 的 字符 串 或 文人 
e pattern 

应 用 于 source 字符 串 的 正则 表达 式 模式 。 
。 isFileName 


如 果 source 是 文件 名 ， 则 传 入 true; 如 果 source 是 字符 串 ， 则 传 入 false, 
该 方法 返回 一 个 List<string>， 其 中 包含 找到 正则 表达 式 匹 配 的 每 一 行 的 字符 串 。 


GetLines 方法 可 以 获得 字符 串 或 文件 内 出 现 匹配 的 行 。 当 对 一 个 文件 运行 正则 表达 式 时 ， 
该 文件 的 名 称 传人 GetLines 方法 中 的 source 参数 中 (24 isFileName 等 于 true 时 )， 就 会 
打开 并 逐 行 读 取 该 文件 。 对 每 一 行 运行 正则 表达 式 ， 如 果 找 到 一 个 匹配 ， 就 把 该 行 存储 在 
matchedLines List<string> 中 。 使 用 StreamReader 对 象 的 ReadLine 方法 ， 无 需 确定 每 一 
行 开 始 和 结束 于 何 处 。 确 定 字符 串 中 某 一 行 开 始 和 结束 于 何 处 需要 一 些 工作 ， 下 面 将 会 看 
到 这 一 点 。 


对 传人 GetLines 方法 中 source 参数 的 字符 串 运行 正则 表达 式 (24 isFileName 等 于 false 
时 ) 将 会 产生 一 个 MatchCollection。 该 集合 中 的 每 个 Match 对 象 用 于 获得 source 字符 串 
中 匹配 所 在 的 行 。 获 得 行 的 方法 如 下 : 从 source 字符 串 中 匹配 的 第 一 个 字符 所 在 位 置 开 
始 ， 向 左 移动 一 个 字符 ， 直 至 找到 一 个 \n 字符 或 者 找到 source 字符 串 的 开头 〈 可 以 在 
GetBeginningOfLine 方法 中 找到 这 段 代 码 )。 这 将 指示 行 的 开头 ， 它 位 于 变量 lineStartPos 
中 。 接 下 来 ， 找 到 行 的 结尾 ， 其 方法 如 下 : 首先 从 source 字 符 串 中 匹配 的 最 后 一 个 
字符 所 在 位 置 开始 ， 并 向 右 移动 ， 直 至 找到 一 个 \n 字符 或 者 找到 source 字符 串 的 结 
Je (可 以 在 GetEndofLine 方法 中 找到 这 段 代 码 )。 这 个 结尾 位 置 位 于 LineEndPos 变量 中 。 
lineStartPos 和 LineEndPos 之 间 的 所 有 文本 将 是 在 其 中 找到 匹配 的 行 。 将 所 有 这 些 行 添加 
到 matchedLines List<string> 中 并 返回 调用 者 。 
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可 以 利用 GetLines 方法 所 做 的 一 件 有 趣 的 事件 是 : 在 该 方法 的 pattern 参数 中 传人 字符 串 
"\n"。 这 种 技巧 实际 上 会 返回 字符 串 或 文件 的 每 一 行 ， 作 为 List<string> 中 的 字符 串 。 尽 
管 这 个 方法 可 用 于 内 和 髓 CRLF 字符 的 字符 串 ， 但 是 不 能 用 于 从 文件 中 读 出 来 的 文本 。 原 因 
是 前 面 的 GetLines 方法 中 的 ReadLine 方法 会 去 除 CRLF 字符 。 要 修正 这 个 问题 ， 可 以 在 
GetLines 方法 中 执行 匹配 时 ， 简 单 地 把 这 些 字符 添加 回去 。 

要 解决 此 问题 ， 我 们 可 以 简单 地 将 这 些 字符 添加 回去 ， 因 为 我 们 在 GetLines 方法 中 执行 
匹配 。 

// 增加 CRLF 字 符 是 有 必要 的 


// 因为 ReadLine() 移 除了 这 些 字符 
if (RE.IsMatch(text + Environment.NewLine)) 


最 后 ， 要 注意 如 果 在 一 行 中 找到 多 个 匹配 ， 会 把 每 个 匹配 行 添加 到 List<string> 中 。 


当 把 换行 符 添加 回 文本 时 要 小 心 。 如 果 你 仅 在 Windows 系统 上 使 用 和 处 理 文 
本 ， 将 不 会 有 任何 问题 。 然 而 ， 如 果 你 使 用 其 他 系统 或 者 混用 多 个 系统 ， 就 
需要 确保 添加 了 正确 的 换行 符 ， 也 就 是 说 ， 对 于 Unix 和 OS X， 仅 使 用 换行 
fF (Ww), 


















































7.5.4 参考 


MSDN x fh rn AY “.NET Framework JE lll| 35 Ųų” “FileStream 类 ”和 “StreamReader 类 ” 
主题 。 


7.6 ”找到 特定 次 数 的 匹配 


7.6.1 问题 

你 需要 找到 字符 串 内 出 现 的 特定 次 数 的 匹配 。 例 如 ， 你 希望 找到 一 个 单词 第 三 次 出 现 的 位 
置 或 者 一 个 社会 安全 号 码 第 二 次 出 现 的 位 置 。 此 外 ， 你 还 可 能 需要 在 字符 串 中 找到 一 个 单 
词 每 隔 三 次 出 现 的 位 置 。 


7.6.2 ”解决 方案 
为 了 找到 字符 串 中 特定 出 现 次 数 的 匹配 ， 只 需 对 Regex. Matches 返回 的 数组 使 用 下 标 即 可 ， 
代码 如 下 所 示 。 


public static Match FindOccurrenceOf(string source, string pattern, 
int occurrence) 

















{ 
if (occurrence < 1) 
{ 
throw (new ArgumentException("Cannot be less than 1", 
nameof(occurrence))); 
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// 使 occurrence 从 0 计数 


--occurrence; 


// 对 source 字 符 串 运行 一 次 正则 表达 式 
Regex RE = new Regex(pattern, RegexOptions.Multiline); 
MatchCollection theMatches = RE.Matches(source); 


if (occurrence >= theMatches.Count) 


{ 
return (null); 
} 
else 
{ 
return (theMatches[occurrence]); 
} 


} 
为 了 在 字符 串 中 找到 每 个 特定 出 现 次 数 的 匹配 ， 可 以 实时 构建 一 个 List<Match>, 


public static List<Match> FindEachOccurrenceOf(string source, string pattern, 
int occurrence) 





{ 


if (occurrence < 1) 


{ 


throw (new ArgumentException("Cannot be less than 1", 
Nameof (occurrence) )); 


} 


List<Match> occurrences = new List<Match>(); 


// 对 source 字 符 串 运行 一 次 正则 表达 式 
Regex RE = new Regex(pattern, RegexOptions.Multiline); 
MatchCollection theMatches = RE.Matches(source); 


for (int index = (occurrence - 1); index < theMatches.Count; 
index += occurrence) 


{ 
} 


occurrences .Add(theMatches[index]); 


return (occurrences); 


} 
i 的 方法 展示 了 如 何 调用 前 面 两 个 方法 。 


public static void TestOccurrencesOf() 


{ 











T 











IT 











Match matchResult - FindOccurrenceOf 

("one two three one two three one two three one" 

+ " two three one two three one two three", "two", 2); 
Console.WriteLine($"{matchResult?.ToString()}\t{matchResult?.Index}"); 


Console.WriteLine(); 

List<Match> results = FindEachOccurrenceOf 
("one one two three one two three one 
+ " two three one two three", "one", 2); 





foreach (Match m in results) 
Console.WriteLine($"{m.ToString()}\t{m.Index}"); 
} 


7.6.3 讨论 

本 范例 包含 两 个 类 似 但 截然 不 同 的 方法 。 第 一 个 方法 FindOccurrenceof 返回 一 个 特定 出 现 
次 数 的 正则 表达 式 匹 配 。 通 过 occurrence 参数 将 你 想 要 找到 的 出 现 次 数 传人 该 方法 中 。 如 
果 特 定 次 数 的 匹配 不 存在 (例如 ， 你 要 求 找到 第 二 次 出 现 的 匹配 ， 但 是 只 存在 一 个 匹配 )， 
就 会 从 该 方法 返回 null。 因 此 ， 在 使 用 该 方法 返回 对 象 之 前 应 该 确定 它 不 是 null, RNR AE 
在 特定 的 匹配 ， 就 会 返回 存 有 该 次 匹配 信息 的 Match 对 象 。 

本 范例 中 的 第 二 个 方法 FitndEachoccurrenceof 的 工作 方式 类 似 于 FindOccurrenceof 方法 ， 
只 不 过 它 将 继续 查找 正则 表达 式 的 特定 次 数 匹配 ， 直 至 到 达 字 符 串 的 末尾 。 例 如 ， 如 果 你 
要 求 找到 第 二 次 出 现 的 匹配 ， 该 方法 将 返回 0 个 、1 个 或 多 个 Match 对 象 的 List<Match>, 
Match 对 象 将 对 应 于 第 二 次 、 第 四 次 、 第 六 次 和 第 八 次 出 现 的 匹配 ， 依 此 类 推 ， 直 至 到 达 
字符 串 的 末尾 。 


7.6.4 ”参考 


MSDN 文档 中 的 “.NET Framework 正则 表达 式 ” 和 “ArrayList 类 ”主题 。 


7.7 ”使 用 常见 模式 


7.7.1 问题 


你 需要 一 个 快速 列表 ， 可 从 中 选择 匹配 标准 数据 项 的 正则 表达 式 模式 。 这 些 标准 数据 项 可 
以 是 社会 安全 号 码 、 邮 政 编码 、 只 包含 字符 的 单词 、 包 含 字母 和 数字 的 单词 、 电 子 邮 件 地 
址 、URL、 日 期 ， 也 可 以 是 各 种 商业 应 用 程序 中 使 用 的 其 他 可 能 的 数据 项 。 

这 些 模式 可 用 于 确保 用 户 输入 正确 的 数据 并 且 格式 标准 。 也 可 以 把 这 些 模 式 用 作 额 外 的 安 
全 措施 ， 阻 止 黑客 通过 输入 怪异 的 或 畸形 的 数据 (例如 ，SQL 注入 或 跨 站 脚本 攻击 ) 试 
图 损坏 你 的 代码 。 注 意 ， 这 些 正则 表达 式 并 不 是 阻止 针对 系统 的 所 有 攻击 的 银 弹 ， 确切 地 
讲 ， 它 们 只 是 附加 的 防御 层 。 


7.7.2 解决 方案 


。 只 匹配 字母 数字 字符 以 及 字符 -、+、. 和 任何 空白 : 
“(T\w\.\t\-]1\s)*$ 


在 字符 类 (封闭 在 方 括号 [ 和 ] 内 的 正则 表达 式 ) 中 要 小 心 使 用 - GES 
符 )。 该 字符 也 用 于 指定 字符 的 范围 ， 比 如 a-z 表示 从 a 到 z ( 含 a 和 z)。 如 
果 想 使 用 字面 量 - 字符 ， 就 要 用 \ 对 它 进行 转 义 ， 或 者 把 它 放 在 表达 式 的 末 
尾 ， 如 下 一 个 示例 所 示 。 
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。 只 匹配 字母 数字 字符 以 及 字符 -、+、. 和 任何 空白 ， 同 时 规定 至 少 有 甚 中 的 1 个 字符 ， 


并 且 不 超过 10 个 字符 : 
~^C[\W\.\t\-]JI\s){1,10}$ 


。 匹配 人 名 ， 最 多 55 个 字符 : 
Afa-zA-Z\'\-\s]{1,55}$ 

。 匹配 正 整数 或 负 整 数 : 
^(\+|\-)?\d+$ 

。 只 匹配 正 浮 点 数 或 负 浮 点 数 ， 该 模式 不 匹配 整数 : 
^(\+|\-)?C\d*\.\d+)$ 

。 匹配 可 以 具有 正 、 负 值 的 浮 点 数 或 整数 : 
^(\+|\-)?C\d*\.)?\d+$ 











。 匹配 HHH 形式 的 日 期 ， 其 中 日 和 月 可 以 是 1 位 或 2 位 值 ， 年 只 能 是 4 位 值 : 





\d{1,2}\/\d{1,2}\/\d{4}$ 


。 验证 输入 是 否 是 HS SERIA RASH: 


\d{3}-\d{2}-\d{4}$ 


。 匹配 IJPv4 地 址 : 
^([0-2]?[0-9]?[0-9]\.){3}[0-2]?[0-9]?[0-91$ 


。 验证 电子 邮件 地 址 是 否 具有 name @address 形式 ， 














^[A-Za-z0-9_\-\.]+@(([A-Za-z0-9\-])+\.)+([A-Za- 








其 中 address 不 是 一 个 卫 地 址 : 


z\-])+$ 


。 验证 电子 邮件 地 址 是 否 具 有 name @address 形式 ， 其 中 address 是 一 个 IP HALL: 
ATA-Za-z0-9_\-\.]+@([0-2]?[0-9]?[0-9]\.){3}[0-2]?[0-9]?[0-9]$ 


。 匹配 或 验证 使 用 HTTP、HTTPS 或 FTP 协议 的 URL。 注 意 ， 该 正则 表达 式 不 匹配 相对 








URL: 


Achttp|https|ftp)\://[a-zA-Z0-9\-\.]+\.[a-zA-Z]{2,3}(:[a-zA-Z0-9]*)?/? 


([a-zA-Z0-9\-\._\?\,\"/\\\+8%\S#\=~] )*$ 


。 只 匹配 美元 金额 , 带 有 可 选 的 $ 以 及 + 或 - 前 级 字符 (注意 , 可 以 添加 任意 数量 的 小 数位 ): 





^S? [8-2 [Nd ]*(\.\d*)?$ 





这 类 似 于 前 一 个 正则 表达 式 ， 只 不 过 允许 的 小 数位 不 能 超过 2 位: 


^$? [+-]?[\d, ]*\.?\d{0,2}$ 
。 匹配 作为 4 组 4 位 数字 输入 的 信用 卡号 ， 可 以 用 


^COd(43[- 1?){3}\d{4})$ 








空格 或 - 字符 隔 开 这 4 组 数字 ， 也 可 以 


。 匹配 作为 5 位 数字 输入 的 邮政 编码 ， 带 有 可 选 的 4 位 数字 的 扩展 : 





\d{5}(-\d{4}) 2S 





。 匹配 一 个 北美 的 电话 号 码 ， 带 有 可 选 的 区 号 并 且 可 以 在 电话 号 码 中 使 用 - 字符 ， 设 有 分 





DLS: 
“(\(2[0-9]{3}\)?)2\-?2[0-9]{3}\ -?[0-9] {4}$ 


匹配 类 似 于 前 一 个 正则 表达 式 的 电话 号 码 ， 但 是 允许 可 选 的 5 位 分 机 号 ， 前 级 为 ext 或 
extension; 


*(\(7[0-91{3}\)?)?\-?[0-9]{£3}\-? [0-9] (A (\s*ext (ension)?[0-9]{5})?$ 


匹配 以 驱动 器 字母 开头 的 完整 路 径 ， 并 且 可 选择 地 匹配 带 有 3 字符 扩展 名 的 文件 名 GE 

意 ， 不 允许 任何 表示 向 上 移动 目录 层次 结构 的 字符， 也 不 允许 点 C.) 后 面 跟着 扩展 

名 的 目录 名 ) : 
^[a-zA-Z]:[\\/]([_a-zA-z6-9]+[\\/]?)*([_a-zA-Z9-9]+\.[_a-zA-Z0-9]{6,3])?$ 


验证 输入 密码 字符 串 是 否 匹 配 用 于 输入 密码 的 一 些 指定 规则 ( 即 密码 长 度 在 6-25 个 字 
符 之 间 ， 并 且 包 售 字母 和 数字 字符 ) : 

^(?=.*\d)(?=.*[a-z])(?=.*[A-Z]).{6,25}$ 
确定 用 户 是 否 输入 了 任何 恶意 字符 。 注 意 ， 该 正则 表达 式 不 仅 会 阻止 所 有 恶意 输入 ， 
会 阻止 一 些 合法 的 输入 ， 比 如 包含 单 引 号 的 姓氏 : 
^([^A\)NCNA<\>N\ AN \% 8\4\5 JEC-{2})])*S 

从 XHTML、HTML 或 XML 字符 串 中 提取 标签 。 该 正则 表达 式 将 返回 开始 标签 和 结束 
标签 ， 包 括 标签 的 任何 属性 。 注 意 ， 需 要 用 想 要 查找 的 真实 标签 名 称 禁 换 TAGNAME: 


«TAGNAME . *?»( .*?)</ TAGNAME> 
从 代码 中 提取 注释 行 。 下 面 的 正则 表达 式 从 Web 页 面 中 提取 HTML 注释 。 这 可 用 于 确 
定 在 投入 实际 应 用 前 是 否 需要 从 代码 库 中 删除 任何 泄露 了 敏感 信息 的 HTML ERE: 


| 人 









































匹配 CH 单行 注释 : 
/[.*$ 
匹配 CH 多 行 注释 : 
A A 





虽然 前 述 的 4 个 正则 表达 式 非常 适合 于 查找 标签 和 注释 ， 但 它们 不 是 万 无 
一 失 的 。 为 了 准确 查找 所 有 的 标签 和 注释 ， 需 要 使 用 针对 目标 语言 的 完 
解析 器 。 














7.7.8 讨论 


正则 表达 式 可 以 有 效 地 查找 特定 的 信息 ， 并 且 它 们 具有 广泛 的 使 用 范围 。 许 多 应 用 程序 使 
用 它们 来 查找 更 大 范围 文本 内 的 特定 信息 ， 并 且 过 庆 掉 有 害 的 输入 。 在 加 强 应 用 程序 的 安 
全 以 及 防止 墨客 试图 用 精心 构造 的 输入 来 狭 得 互联 网 或 局 域 网 上 机 器 的 访问 权限 方面 ， 过 
诺 操 作 非 常 有 用 。 使 用 正则 表达 式 只 允许 将 良好 的 输入 传递 给 应 用 程序 ， 可 以 减少 发 生 多 
种 攻击 的 可 能 性 ， 比 如 SQL 注入 或 跨 站 脚本 攻击 。 
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本 范例 中 展示 的 正则 表达 式 只 提供 了 关于 可 以 利用 它们 完成 什么 任务 的 简单 介绍 。 可 以 轻 
从 地 修改 这 些 表 达 式 来 满足 你 的 需求 。 例 如 ， 如 下 表达 式 只 允许 输入 1-10 之 间 的 数字 字 
符 以 及 少数 儿 个 符号 。 

^C. \t\-]I\s){1,10}$ 
通过 把 正则 表达 式 的 {1,10} 部 分 更 改 为 {9,290}， 该 正则 表达 式 现在 将 匹配 空白 条 目 或 者 
最 多 包含 200 个 字符 的 指定 符号 的 条 目 。 


注意 在 表达 式 开 头 使 用 的 “字符 和 在 表达 式 末尾 使 用 的 $ 字符 。 这 些 字符 从 文本 开始 处 开 
始 匹 配 ， 并 一 直 匹 配 到 文本 末尾 。 添 加 这 些 字符 将 强制 正则 表达 式 匹配 整个 字符 串 或 者 一 
点 也 不 匹配 。 通 过 删除 这 些 字符 ， 可 以 查找 大 块 文本 内 的 特定 文本 。 例 如 ， 下 面 的 正则 表 
达 式 仅仅 匹配 其 中 只 包含 美国 邮政 编码 (不 能 有 前 导 或 尾随 空格 ) 的 字符 串 。 


“\d{5}(-\d{4}) 2S 


下 面 这 个 版 本 只 匹配 具有 前 导 或 尾随 空格 的 邮政 编码 (注意 ， 在 表达 式 的 开头 和 末尾 添加 
TNS) 


^\s*\d{5}(-\d{4})?\s*$ 
不 过 ， 下 面 这 个 经 过 修改 的 表达 式 匹 配 字符 串 内 任意 位 置 找到 的 邮政 编码 〈 包 括 只 包含 邮 
政 编码 的 字符 串 )。 

\d{5}(-\d{4})? 
使 用 本 范例 中 介绍 的 正则 表达 式 ， 并 修改 它们 以 请 足 你 的 需求 。 


7.7.4 参考 


Michael Fitzgerald 车 的 《学 习 正 则 表达 式 》 以 及 Jan Goyvaerts 和 Steven Levithan & HY 
《正则 表达 式 经 典 实 例 》。 这 两 本 英文 原 书 都 是 由 O^ Reilly 出 版 的 。 







































































第 8 和 章 


文件 系统 1/0 





8.0 简介 


本 章 处 理 一 些 与 文件 系统 有 关 的 主题 ， 如 基于 目录 或 文件 夹 的 编程 任务 。 本 章 也 提 到 了 下 
面 这 些 文件 系统 VO (输入 /输出 ) 中 更 高 级 的 主题 。 

。 锁定 文件 的 一 部 分 

。 监控 某 些 文件 系统 行为 

。 文件 中 的 版 本 信息 

。 文件 压缩 

各 种 文件 和 目录 VO 技术 的 使 用 贯穿 在 各 个 范例 中 ， 展 示 了 如 何 执行 创建 、 打 开 、 删 除 、 读 
取 和 写 人 文件 和 目录 等 任务 。 这 些 基本 知识 有 助 于 用 户 理解 其 他 文件 VO. 范例 以 及 如 何 根 
据 用 户 目标 进行 修改 。 

多 个 范例 已 更 新 以 使 用 async 和 await 运算 符 帮助 减轻 处 理 文件 系统 、 网 络 或 文件 IO 时 
通常 会 遇 到 的 延迟 。 使 用 async 和 await 通过 允许 VO 操作 进行 但 不 会 像 通 常 那样 在 完成 
前 阻塞 调用 线程 ， 从 而 提高 了 代码 的 整体 响应 能 

除非 另 有 说 明 ， 在 使 用 本 章 中 的 代码 片段 或 方法 的 任何 程序 中 ， 都 需要 下 列 using 语句 。 


using System; 
using System.IO; 
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8.1 使 用 通配符 查找 目录 和 文件 


8.1.1 问题 


你 正在 尝试 在 当前 文件 系统 中 查找 可 能 存在 也 可 能 不 存在 的 一 个 或 多 个 特定 文件 或 目录 。 
搜索 可 能 需要 使 用 通配符 ， 以 便 扩大 搜索 。 例 如 ， 搜 索 一 个 文件 系统 中 所 有 用 户 模式 的 转 
储 文件 。 这 些 文件 都 具有 .dmp 扩展 名 。 


8.1.2 解决 方案 
获得 这 一 信息 有 几 种 方法 。 前 三 种 方法 返回 一 个 包含 每 个 数据 项 的 完整 路 径 的 字符 串 数 
组 。 接 下 来 的 三 种 方法 返回 一 个 封装 了 一 个 目录 、 一 个 文件 或 者 全 部 两 者 的 对 象 。 


Directory 类 上 的 静态 GetFileSystemEntries 方法 返回 一 个 包含 单个 目录 内 所 有 文件 和 目 
录 名 的 字符 串 数 组 ， 如 下 所 示 。 


public static void DisplayFilesAndSubDirectories(string path) 


























{ 
if (string. IsNuLlOrWhiteSpace(path) ) 
throw new ArgumentNuLLException(nameof (path) ) ; 
string[] items = Directory.GetFileSystemEntries(path) ; 
Array.ForEach(items, item => 
{ 
Console.WriteLine(item) ; 
IDE 
} 





pum 


Directory 类 上 的 静态 GetDirectories 方法 返回 一 个 包含 单个 目录 内 所 有 目录 名 的 字符 
数组 。 下 面 的 DisplaySubDirectories 方法 展示 了 你 可 以 如 何 使 用 它 。 


public static void DisplaySubDirectories(string path) 








{ 
if (string.IsNullOrWhiteSpace(path)) 
throw new ArgumentNuLLException(nameof (path) ) ; 
string[] items = Directory.GetDirectories(path) ; 
Array.ForEach(items, item => 
{ 
Console.WriteLine(item) ; 
]); 
} 


Directory 类 的 静态 GetFiles 方法 返回 一 个 包含 单个 目录 内 所 有 文件 名 的 字符 串 数 组 。 
下 列 方法 与 DispLaySubDirectories 非常 类 似 ， 但 调用 的 是 Directory.GetFiles 而 不 是 
Directory.GetDirectories, 








public static void DisplayFiles(string path) 


{ 
if (string.IsNullOrWhiteSpace(path)) 
throw new ArgumentNullException(nameof(path)); 
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string[] items = Directory.GetFiles(path); 
Array.ForEach(items, item => 


{ 
Console.WriteLine(item) ; 


})s 
} 


接 下 来 的 两 个 方法 返回 一 个 对 象 而 不 是 仅仅 返回 一 个 字符 串 。DirectoryInfo 对 象 
的 GetFileSystemInfos 方法 返回 一 个 代表 单个 目录 内 目录 和 文件 的 FileSystemInfo 对 
象 (也 就 是 DirectoryInfo 和 FileInfo 对 象 ) 构成 的 强 类 型 数组 。 下 面 的 示例 调用 
GetFileSystemInfos 方法 以 获取 一 个 由 代表 某 个 特定 目录 中 所 有 项 的 FiLeSystemInfo 对 象 

















构成 的 数组 ， 然 后 在 控制 台 窗 口中 列 出 一 个 关于 FilesystemInfo 的 显示 信息 字符 串 。 显 示 


信息 由 FileSystemInfo 上 的 扩展 方法 ToDisplayString 生成 。 


public static void DisplayDirectoryContents(string path) 
{ 
if (string.IsNullOrWhiteSpace(path)) 
throw new ArgumentNullException(nameof(path)); 


DirectoryInfo mainDir = new DirectoryInfo(path); 

var fileSystemDisplayInfos = 
(from fsi in mainDir.GetFileSystemInfos() 
where fsi is FileSystemInfo || fsi is DirectoryInfo 
select fsi.ToDisplayString()).ToArray(); 


Array.ForEach(fileSystemDisplayInfos, s => 


{ 
Console.WriteLine(s); 
35 
} 


public static string ToDisplayString(this FileSystemInfo fileSystemInfo) 
{ 
string type = fileSystemInfo.GetType().ToString(); 
if (fileSystemInfo is DirectoryInfo) 
type = "DIRECTORY"; 
else if (fileSystemInfo is FileInfo) 
type = "FILE"; 
return $"{type}: {fileSystemInfo.Name}"; 
} 


这 段 代 码 的 输出 如 下 所 示 。 


DIRECTORY: MyNestedTempDir 
DIRECTORY: MyNestedTempDirPattern 
FILE: MyTempFile.PDB 

FILE: MyTempFile. TXT 


DirectoryInfo 对 象 的 GetDirectories 实例 方法 仅 返 回 一 个 代表 单个 目录 下 子 目 录 
的 DirectoryInfo 对 象 的 数组 。 例 如 ， 下 列 代 码 调 用 GetDirectories 方法 以 获得 一 个 








DirectoryInfo 对 象 的 数组 ， 然 后 将 每 个 对 象 的 Name 属性 显示 到 控制 台 窗 口 。 
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public static void DisplayDirectoriesFromInfo(string path) 


{ 
if (string. IsNuLlOrWhiteSpace(path) ) 
throw new ArgumentNuLLException(nameof (path) ) ; 


DirectoryInfo mainDir = new DirectoryInfo(path); 
DirectoryInfo[] items = mainDir.GetDirectories(); 
Array.ForEach(items, item => 


{ 
Console.WriteLine($"DIRECTORY: {item.Name}"); 
DE 
} 


DirectoryInfo 对 象 的 GetFiles 实例 方法 仅 返 回 一 个 代表 单个 目录 下 文件 的 FileInfo 对 象 
的 数组 。 例 如 ， 以 下 代码 调用 GetFiles 方法 以 获得 一 个 FileInfo 对 象 的 数组 ， 然 后 将 每 
个 对 象 的 Name 属性 显示 到 控制 台 窗口 。 


public static void DisplayFilesFromInfo(string path) 


{ 





if (string.IsNullOrWhiteSpace(path)) 
throw new ArgumentNuLLException(nameof (path) ); 


DirectoryInfo mainDir = new DirectoryInfo(path); 
FileInfo[] items = mainDir.GetFiles(); 
Array.ForEach(items, item => 


{ 
Console.WriteLine($"FILE: {item.Name}"); 
DE 
} 


Directory 类 上 的 静态 GetFileSystemEntries 75 7:18 [Al HL 4S H oe P BU VC ic EK xc f 
目录 。 


public static void DisplayFilesWithPattern(string path, string pattern) 


{ 


和 


ay 








if (string. IsNuLlOrWhiteSpace(path) ) 
throw new ArgumentNuLLException(nameof (path) ) ; 
if (string. IsNuLlOrWhiteSpace(pattern) ) 
throw new ArgumentNuLLException(nameof (pattern) ) ; 


string[] items = Directory.GetFileSystemEntries(path, pattern); 
Array.ForEach(items, item => 


{ 
Console.WriteLine(item); 
F; 
} 


Directory 类 上 的 静态 GetDirectories 方法 仅 返 回 单个 目录 下 所 有 匹配 模式 的 目录 。 


public static void DisplayDirectoriesWithPattern(string path, string pattern) 


{ 





if (string.IsNullOrWhiteSpace(path)) 
throw new ArgumentNuLLException(nameof (path) ) ; 
if (string. IsNuLlOrWhiteSpace(pattern) ) 
throw new ArgumentNuLLException(nameof (pattern) ) ; 
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string[] items = Directory.GetDirectories(path, pattern); 
Array.ForEach(items, item => 


{ 
Console.WriteLine(item) ; 
35 
} 


Directory 类 上 的 静态 GetFiles 方法 仅 返回 单个 目录 下 所 有 匹配 模式 的 文件 。 


public static void DisplayFilesWithGetFiles(string path, string pattern) 


( 





if (string.IsNullOrWhiteSpace(path)) 
throw new ArgumentNullException(nameof(path)); 
if (string.IsNullOrWhiteSpace(pattern)) 
throw new ArgumentNullException(nameof(pattern)); 


string[] items = Directory.GetFiles(path, pattern); 
Array.ForEach(items, item => 


{ 
Console.WriteLine(item) ; 
35 
} 
接 下 来 的 三 个 方法 返回 一 个 对 象 而 不 是 仅仅 返回 一 个 字符 串 。 第 一 个 实例 方法 是 
GetFiLeSystemInfos， 它 返回 单个 目录 内 匹配 模式 的 目录 和 文件 。 


public static void DisplayDirectoryContentsWithPattern(string path, 
string pattern) 





{ 
if (string.IsNullOrWhiteSpace(path)) 
throw new ArgumentNullException(nameof(path)); 
if (string.IsNullOrWhiteSpace(pattern)) 
throw new ArgumentNullException(nameof(pattern)); 
DirectoryInfo mainDir - new DirectoryInfo(path); 
var fileSystemDisplayInfos - 
(from fsi in mainDir.GetFileSystemInfos(pattern) 
where fsi is FileSystemInfo || fsi is DirectoryInfo 
select fsi.ToDisplayString()).ToArray(); 
Array.ForEach(fileSystemDisplayInfos, s => 
{ 
Console.WriteLine(s); 
DE 
} 


GetDirectories 实例 方法 仅 返回 单个 目录 内 匹配 模式 的 目录 (包含 在 DirectoryInfo 对 
象 中 )。 


public static void DisplayDirectoriesWithPatternFromInfo(string path, 
string pattern) 








{ 
if (string.IsNullOrWhiteSpace(path)) 
throw new ArgumentNullException(nameof(path)); 
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if (string. IsNuLlOrWhiteSpace(pattern) ) 


throw 


new ArgumentNuLLException(nameof (pattern) ); 


DirectoryInfo mainDir = new DirectoryInfo(path); 
DirectoryInfo[] items = mainDir.GetDirectories(pattern); 
Array.ForEach(items, item => 


{ 


Console.WriteLine($"DIRECTORY: {item.Name}"); 


p; 
} 





GetFiles 实例 方法 仅 返回 单个 目录 内 匹配 模式 的 文件 信息 (包含 在 FileInfo 对 象 中 )。 


public static 








void DisplayFilesWithInstanceGetFiles(string path, string pattern) 


if (string.IsNullOrWhiteSpace(path)) 


throw 


new ArgumentNullException(nameof(path)); 


if (string.IsNullOrWhiteSpace(pattern)) 


throw 


new ArgumentNullException(nameof(pattern)); 


DirectoryInfo mainDir - new DirectoryInfo(path); 
FileInfo[] items - mainDir.GetFiles(pattern); 
Array.ForEach(items, item => 


Console.WriteLine($"FILE: {item.Name}"); 


p; 


8.1.3 讨论 




















如 果 只 需要 一 个 包含 目录 和 文件 路 径 的 字符 串 数 组 ， 那 么 可 以 使 用 静态 方法 Directory. 


GetFileSystemEntri 





es。 返 回 的 字符 串 数 组 不 包含 任何 关于 一 个 单独 元 素 是 目录 还 是 文件 














的 信息 。 每 个 字符 
为 了 快速 、 简 易 地 
GetFiles 静态 方法 。 


元 素 包 含 指向 特定 路 径 内 包含 的 某 个 目录 或 文件 的 完整 路 径 。 


辨认 出 目录 和 文件 ， 可 使 用 Directory.GetDirectories 和 Directory. 
这 些 方法 返回 目录 名 和 文件 名 的 数组 。 这 些 方 法 返回 一 个 字符 串 对 象 

















的 数组 。 每 个 元 素 包 含 目录 或 文件 的 完整 路 径 。 


如 果 用 户 不 需要 关于 所 返回 的 目录 或 文件 的 任何 其 他 信息 ， 或 者 如 果 用 户 需要 所 返回 的 
其 中 一 个 文件 的 更 多 信息 ， 那 么 返回 一 个 字符 串 就 可 以 了 。 使 用 静态 方法 获得 文件 名 列 






































表 并 且 仅 获取 用 户 所 需 的 FileInfo 比 构造 目录 下 所 有 的 FileInfo 更 有 效率 ， 就 如 实例 方 
法 将 会 做 的 那样 。 如 果 必 须 访问 每 个 文件 的 属性 、 长 度 或 时 间 ， 那 么 应 当 考 虑 使 用 获取 
FileInfo 细节 的 实例 方法 。 


实例 方法 GetFiLeSystemInfos 返回 一 个 强 类 型 FileSsystemInfo 对 象 构 成 的 数组 





(FileSystemInfo 对 











象 是 DirectoryInfo 和 FileInfo 对 象 的 基 类 )。 因 此 ， 使 用 is 或 as 关 








键 字 就 可 以 测试 返回 的 类 型 是 一 个 DirectoryInfo 对 象 还 是 一 个 FileInfo 对 象 。 一 旦 知道 
了 该 对 象 实际 是 哪 一 个 子 类 ， 就 可 以 将 其 类 型 转换 到 子 类 并 开始 使 用 它 。 

H (X. 3k f& DirectoryInfo 对 象 ， 可 使 用 重 载 的 GetDirectories 实例 方法 。 要 仅 获 得 
FileInfo 对 象 ， 可 使 用 重 载 的 GetFiles 实例 方法 。 这 些 方法 分 别 返 回 一 个 DirectoryInfo 
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和 FileInfo 对 象 构成 的 数组 ， 每 个 数组 的 元 素 都 封装 了 一 个 目录 或 文件 。 

当 从 GetFiles 或 GetFiLeSystemInfos 中 过 滤 结 果 时 ， 可 提供 的 模式 有 以 下 这 些 需 要 注意 的 

行为 。 

。 模式 不 能 包含 任何 InvalidPathChars, 并 且 不 能 使 用 在 目录 结构 中 回 到 上 一 个 级 别 的 ..。 

。 返回 的 数组 中 项 的 顺序 不 能 确定 ， 但 是 可 以 使 用 Sort 或 者 在 一 个 查询 中 对 结果 排序 。 

。 当 扩 展 名 恰好 是 3 个 字符 时 ， 行 为 有 些 不 同 : 模式 将 与 任何 在 扩展 名 中 包括 这 3 个 字符 
的 文件 匹配 。 

。 *.htm 返 回 带 有 扩展 名 为 .htm、.html、.htma 等 的 文件 。 

。 当 一 个 扩展 名 少 于 或 多 于 3 字符 时 ， 模 式 将 执行 精确 匹配 。 

。 *.cs 仅 返 回 扩展 名 为 .cs 的 文件 。 


8.1.4 参考 


MSDN 文档 中 的 “DirectoryInfo 2” “FileInfo 类 ”和 “FiLeSystemInfo 类 ”主题 。 


8.2 获取 目录 树 


8.2.1 问题 

你 需要 获得 一 棵 目录 树 ， 可 能 包含 文件 名 ， 从 目录 层次 内 的 任意 一 点 扩展 开 来 。 此 外 ， 返 
回 的 每 个 目录 或 文件 必须 具有 封装 该 项 的 对 象形 式 。 这 样 允许 你 在 返回 的 对 象 上 执行 操 
作 ， 例 如 删除 文件 、 重 命名 文件 或 者 检查 / 修改 其 属性 。 最 后 ， 你 可 能 需要 根据 一 个 模式 
搜索 指定 子 集 的 能 力 ， 例 如 仅 查 找 具 有 .pdb 扩展 名 的 文件 。 


8.2.2 解决 方案 


通过 调用 GetFilesystemInfos 实例 方法 ， 可 以 获取 从 任何 起 始点 沿 目录 层次 向 下 的 所 有 文 
件 和 目录 所 构成 的 一 个 可 枚 举 列表 ， 代 码 如 下 所 示 。 


public static IEnumerable<FileSystemInfo> GetAllFilesAndDirectories(string dir) 




































































if (string.IsNullOrWhiteSpace(dir)) 
throw new ArgumentNullException(nameof(dir)); 


DirectoryInfo dirInfo = new DirectoryInfo(dir); 
Stack«FileSystemInfo» stack = new Stack<FileSystemInfo>(); 


stack.Push(dirInfo); 
while (dirInfo != null || stack.Count > 0) 
{ 
FileSystemInfo fileSystemInfo = stack.Pop(); 
DirectoryInfo subDirectoryInfo = fileSystemInfo as DirectoryInfo; 
if (subDirectoryInfo != null) 
{ 
yield return subDirectoryInfo; 
foreach (FileSystemInfo fsi in subDirectoryInfo.GetFileSystemInfos()) 
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stack.Push(fsi); 
dirInfo = subDirectoryInfo; 


} 

else 

{ 
yield return fileSystemInfo; 
dirInfo - null; 

} 


} 
要 显示 文件 和 目录 获取 的 结果 ， 可 使 用 下 列 查询 。 


public static void DisplayAllFilesAndDirectories(string dir) 


{ 
if (string.IsNullOrWhiteSpace(dir)) 
throw new ArgumentNullException(nameof(dir)); 
var strings - (from fileSystemInfo in GetAllFilesAndDirectories(dir) 
select fileSystemInfo.ToDisplayString()).ToArray(); 
Array.ForEach(strings, s => { Console.WriteLine(s); }); 
} 


因为 结果 是 可 查询 的 ， 因 此 不 必 获 取 关 于 所 有 文件 和 目录 的 信息 。 下 列 查询 使 用 一 个 不 区 
分 大 小 写 的 比较 来 获得 存在 目 孙 中 所 有 包含 Chapter 1 且 扩 展 名 为 .pdb 的 文件 列表 。 


public static void DisplayAllFilesWithExtension(string dir, string extension) 


{ 





if (string.IsNullOrWhiteSpace(dir)) 
throw new ArgumentNullException(nameof(dir)); 
if (string.IsNullOrWhiteSpace(extension)) 
throw new ArgumentNullException(nameof(extension)); 


var strings = (from fileSystemInfo in GetAllFilesAndDirectories(dir) 
where fileSystemInfo is FileInfo && 
fileSystemInfo.FullName.Contains("Chapter 1") && 
(string.Compare(fileSystemInfo.Extension, extension, 
StringComparison.OrdinallgnoreCase) == 0) 
select fileSystemInfo.ToDisplayString()).ToArray(); 


Array.ForEach(strings, s => { Console.WriteLine(s); }); 


8.2.3 讨论 
要 获得 一 棵 代表 目录 和 它 所 包含 文件 的 树 ， 可 以 在 一 个 方法 中 使 用 递归 式 迭 代 器 ， 如 下 
所 示 。 


public static IEnumerable«FileSystemInfo» GetAllFilesAndDirectoriesWithRecursion( 
string dir) 








{ 
if (string.IsNullOrWhiteSpace(dir)) 
throw new ArgumentNullException(nameof(dir)); 
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DirectoryInfo dirInfo = new DirectoryInfo(dir); 
FileSystemInfo[] fileSystemInfos - dirInfo.GetFileSystemInfos(); 
foreach (FileSystemInfo fileSystemInfo in fileSystemInfos) 


{ 
yield return fileSystemInfo; 
if (fileSystemInfo is DirectoryInfo) 


{ 
foreach (FileSystemInfo fsi in 
GetAllFilesAndDirectoriesWithRecursion(fileSystemInfo.FullName)) 
yield return fsi; 


} 
} 


public static void DisplayAllFilesAndDirectoriesWithRecursion(string dir) 


{ 
if (string.IsNullOrWhiteSpace(dir)) 
throw new ArgumentNullException(nameof(dir)); 


var strings - (from fileSystemInfo in 
GetAllFilesAndDirectoriesWithRecursion(dir) 
select fileSystemInfo.ToDisplayString()).ToArray(); 


Array.ForEach(strings, s => { Console.WriteLine(s); }); 


} 
BRI SEF RGAE SE E, CERNE TARR TT SSE FAS TOS a 
和 一 个 显 式 的 栈 。 
你 不 会 想 使 用 递归 式 迭 代 方 法 ， 因 为 其 性 能 实际 是 0(o*d)， 其 中 中 是 
FileSystemInfos 的 数目 ， 而 d 是 目录 层次 的 深度 ， 它 一 般 等 于 logn。 参 见 
演示 代码 。 
































如 果 解 决 方案 方法 被 分 别 重 命名 为 GetAllFilesAndDirectoriesWithoutRecursion 和 Display- 
AllFilesAndDirectoriesWithoutRecursion， 那 么 可 以 使 用 下 列 代码 检查 其 性 能 。 


string dir = Environment.GetFolderPath(Environment.SpecialFolder.ProgramFiles); 


// 不 使 用 递归 显示 所 有 文件 

Stopwatch watch1 = Stopwatch.StartNew(); 
DisplayAllFilesAndDirectoriesWithoutRecursion(tempDir1); 
watch1.Stop(); 

Console.WriteLine("*dXXxokee ek eek t) ; 














// 使 用 递归 列 出 所 有 文件 
Stopwatch watch2 = Stopwatch.StartNew(); 
DisplayAllFilesAndDirectoriesWithRecursion(tempDir1); 
watch2.Stop(); 
Console.WriteLine('***xxxdeke eee): 
Console.WriteLine( 
$"Non-Recursive method time elapsed {watch1.Elapsed.ToString()}"); 
Console.WriteLine($"Recursive method time elapsed {watch2.Elapsed.ToString()}"); 
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不 使 用 递归 的 方法 如 下 所 示 。 


public static void DisplayAllFilesAndDirectoriesWithoutRecursion(string dir) 


{ 
var strings = from fileSystemInfo in 
GetAllFilesAndDirectoriesWithoutRecursion(dir) 
select fileSystemInfo.ToDisplayString(); 
foreach (string s in strings) 
Console.WriteLine(s); 
} 


public static void DisplayAllFilesWithExtensionWithoutRecursion(string dir, 
string extension) 
{ 
var strings = from fileSystemInfo in 
GetAllFilesAndDirectoriesWithoutRecursion(dir) 
where fileSystemInfo is FileInfo && 
fileSystemInfo.FullName.Contains("Chapter 1") && 
(string.Compare(fileSystemInfo.Extension, extension, 
StringComparison.OrdinallgnoreCase) -- 0) 
select fileSystemInfo.ToDisplayString(); 


foreach (string s in strings) 
Console.WriteLine(s); 


} 


public static IEnumerable<FileSystemInfo> 
GetAllFilesAndDirectoriesWithoutRecursion( 
string dir) 


{ 
DirectoryInfo dirInfo = new DirectoryInfo(dir); 
Stack<FileSystemInfo> stack = new Stack<FileSystemInfo>(); 
stack.Push(dirInfo); 
while (dirInfo != null || stack.Count > 0) 
{ 
FileSystemInfo fileSystemInfo = stack.Pop(); 
DirectoryInfo subDirectoryInfo = fileSystemInfo as DirectoryInfo; 
if (subDirectoryInfo != null) 
{ 
yield return subDirectoryInfo; 
foreach (FileSystemInfo fsi in subDirectoryInfo.GetFileSystemInfos()) 
stack.Push(fsi); 
dirInfo = subDirectoryInfo; 
} 
else 
{ 
yield return fileSystemInfo; 
dirInfo - null; 
} 
} 
} 





8.2.4 参考 


MSDN 文档 中 的 “DirectoryInfo 2” “FileInfo 2” jf “FileSystemInfo 类 ”主题 。 


8.3 


8.3.1 





解析 路 径 


问题 


你 需要 分 离 一 个 路 径 的 组 成 部 分 并 把 它们 存放 在 单独 的 变量 中 。 


8.3.2 ”解决 方案 
使 用 Path 类 的 静态 方法 


public static void DisplayPathParts(string path) 


{ 


} 











if (string.IsNullOrWhiteSpace(path)) 
throw new ArgumentNullException(nameof(path)); 


string root - Path.GetPathRoot(path); 

string dirName - Path.GetDirectoryName(path); 

string fullFileName - Path.GetFileName(path); 

string fileExt - Path.GetExtension(path); 

string fileNameWithoutExt - Path.GetFileNameWithoutExtension(path); 
StringBuilder format - new StringBuilder(); 


format.Append($"ParsePath of {path} breaks up into the following pieces:" + 


$"(Environment.NewLine]"); 
format.Append($"\tRoot: {root}{Environment.NewLine}"); 
format .Append($"\tDirectory Name: {dirName}{Environment.NewLine}"); 
format.Append($"\tFull File Name: {fulLFileName}{Environment.NewLine}"); 
format.Append($"\tFile Extension: {fileExt}{Environment.NewLine}"); 
format.Append($"\tFile Name Without Extension: {fileNameWithoutExt}" + 
$"(Environment.NewLine]"); 
Console.WriteLine(format.ToString()); 


如 果 将 字符 串 C:\test\tempfile. txt 传递 给 该 方法 ， 那 么 输出 如 下 所 示 。 


ParsePath of C:\test\tempfile.txt breaks up into the following pieces: 


8.3.3 
Path 类 包含 可 以 用 于 解析 某 个 给 定 路 径 的 方法 。 与 编写 路 径 解析 和 


Root: C:\ 

Directory Name: C:\test 

Full File Name: tempfile.txt 

File Extension: .txt 

File Name Without Extension: tempfile 


讨论 





文件 名 解析 代码 相 比 ， 


使 用 这 些 类 要 简单 得 多 ， 并 且 不 容易 出 错 。 如 果 不 使 用 这 些 类 ， 在 安全 决策 中 手动 解析 


例 程 中 收集 的 信息 时 ， 也 可 能 会 把 安全 漏洞 带 入 应 月 











程序 。 用 于 解析 路 径 的 五 个 主要 方法 
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是 GetPathRoot, GetDirectoryName, GetFileName, GetExtension 和 GetFileNameWithout - 
Extension。 每 种 方法 都 只 有 一 个 参数 path， 代 表 要 解析 的 路 径 。 
e GetPathRoot 


该 方法 返回 路 径 的 根 目录 。 如 果 路 径 中 没有 根 目录 ， 例 如 使 用 一 个 相对 路 径 时 ， 该 方法 
返回 一 个 空 字符 串 ， 而 不 是 null, 


e GetDirectoryName 
该 方法 返回 文件 所 在 目录 的 完整 路 径 。 
。 GetFileName 
该 方法 返回 文件 名 ， 包 含 文件 的 扩展 名 。 如 果 路 径 中 没有 提供 文件 名 ， 那 么 该 方法 返回 
一 个 空 字符 种， 而 不 是 nutt。 
e GetExtension 


该 方法 返回 文件 的 扩展 名 。 如 果 没 有 提供 文件 的 扩展 名 或 者 路 径 中 不 存在 文件 ， 那 么 该 
方法 返回 一 个 空 字 符 串 ， 而 不 是 null, 
e GetFileNameWithoutExtension 
该 方法 返回 不 带 文件 名 的 根 文件 名 。 
要 注意 ， 这 些 方法 并 非 实际 确定 驱动 器 、 目 录 甚 至 文件 是 否 存在 于 运行 这 些 方法 的 系统 
中 。 这 些 方法 是 字符 串 解析 器 ， 如 果 为 其 中 之 一 传递 一 个 具有 某 种 奇怪 格式 的 字符 串 〈 例 
如 \\ZY:\foo)， 那 么 它 无 论 如 何 都 将 试图 做 它 能 够 解析 的 工作 。 
ParsePath of \\ZY:\foo breaks up into the following pieces: 
Root: \\ZY:\foo 
Directory Name: 
Full File Name: foo 
File Extension: 
File Name Without Extension: foo 


但 是 ， 如 果 路 径 中 发 现 非法 字符 ， 那 么 这 些 方法 将 引发 一 个 异常 。 

要 想 确定 文件 或 目录 是 否 存在 ， 可 使 用 静态 方法 Directory.Exists 或 File.Exists。 
8.3.4 参考 

MSDN 文档 中 的 “Path 类 ”主题 。 


8.4 ”启动 并 与 控制 台 工具 交互 


8.4.1 问题 


你 有 一 个 需要 自动 运行 并 且 仅 从 标准 输入 流 中 获取 输入 的 应 用 程序 。 你 需要 通过 标准 输入 
流 发 送 命令 来 驱动 此 应 用 程序 。 
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8.4.2 解决 方案 
假定 我 们 需要 使 用 TIME /T 命令 驱动 cmd.exe 应 用 程序 显示 当前 时 间 。( 可 以 直接 通过 命 
令 行 运行 该 命令 ， 但 用 这 种 方法 我 们 可 以 展示 一 种 替代 的 方式 去 驱动 一 个 响应 标准 输入 的 
应 用 程序 。) 完成 这 一 工作 的 方法 是 运行 一 个 在 标准 输入 流 上 查找 输入 的 进程 。 这 可 以 通 
过 Process 类 的 StartInfo 属性 完成 ， 它 是 ProcessStartInfo 类 的 一 个 实例 。StartInfo 
的 字段 可 以 控制 新 进程 运行 环境 的 许多 细节 ，Process.Start 将 会 使 用 这 些 选 项 启动 一 个 
新 线程 。 
首先 ， 确 保 将 StartInfo.RedirectStandardInput 属性 设置 为 true。 这 一 设置 通知 进程 ， 它 
应 当 从 标准 输入 中 读 取 。 然 后 ， 将 StartInfo.UseSheLLExecute 属性 设置 为 fatse， 因 为 如 
果 你 打算 让 shell 为 你 运行 该 进程 ， 那 么 它 会 阻止 重 定 向 标准 输入 。 
一 旦 完成 这 些 ， 启 动 该 进程 并 写 入 其 标准 输入 流 ， 如 例 8-1 所 示 。 
例 8-1: RunProcessToReadStandardInput 方法 

public static void RunProcessToReadStandardInput() 


















































{ 
Process application = new Process(); 
// 运行 命令 行 shell 
application.StartInfo.FileName = @"cmd.exe"; 
// 打开 cmd.exe 的 命令 扩展 
application.StartInfo.Arguments = "/E:ON"; 
application. StartInfo.RedirectStandardInput = true; 
application. StartInfo.UseShellExecute = false; 
application. Start(); 
StreamWriter input = application.StandardInput; 
// 运行 命令 以 显示 时 间 
input.WriteLine("TIME /T"); 
// 停止 我 们 启动 的 应 用 程序 
input.WriteLine("exit"); 

} 


8.4.3 讨论 

重 定向 一 个 进程 的 输入 流 允 许 你 以 编程 方式 与 某 些 应 用 程序 和 工具 交互 ， 否 则 需要 额外 的 
工具 才能 实现 自动 化 。 一 旦 输入 被 重 定向 ， 你 就 能 够 通过 读 取 Process.StandardInput 属 
性 返回 一 个 StreamWriter， 然 后 写 入 进程 的 标准 输入 流 。 获 取 了 StreamWriter 后 ， 你 就 能 
够 通过 WriteLine 调用 将 内 容 发 送 到 进程 ， 如 前 所 示 。 

为 了 使 用 StandardInput， 必 须 将 StartInfo 属性 的 RedirectStandardInput 属性 指定 为 
true, ŒM, IRH StandardInput 属性 会 引发 一 个 异常 。 


当 UseShellExecute 为 false I, {RAX fE tE Jf Process 创建 可 执行 的 进程 。 正 常情 况 
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F, Process 类 可 用 于 在 文件 上 执行 操作 ， 例 如 打印 一 份 Microsoft Word 文档 。 当 
UseShellExecute 为 false 时 的 另 一 个 差异 是 工作 目录 不 会 用 于 查找 可 执行 文件 ， 因 此 必须 
注意 传递 一 个 完整 路 径 ， 或 者 将 可 执行 文件 所 在 的 目录 加 入 PATH 环境 变量 。 











844 参考 


MSDN 文档 中 的 “Process 类 ”“ProcessStartInfo %” “RedirectStandardInput 属性 ”和 
“UseShellExecute 属性 ”主题 。 


8.5 锁定 文件 的 一 部 分 


8.5.1 问题 


你 需要 从 一 个 文件 中 部 分 读 取 或 写 入 数据 ， 并 且 希 望 确保 在 完成 这 一 操作 之 前 没有 其 他 进 
程 或 线程 能 够 访问 、 修 改 和 删除 该 文件 。 


8.5.2 ”解决 方案 
锁定 以 防止 其 他 进程 在 你 使 用 文件 时 访问 你 的 文件 ， 可 通过 FileStream 类 的 Lock 方法 完 
成 。 下 列 代码 根据 fileName 参数 生成 一 个 文件 并 写 入 两 行文 本 。 然 后 使 用 Lock 方法 对 整 
个 文件 加 锁 。 当 文件 被 锁定 时 ， 代 码 继续 执行 一 些 其 他 处 理 ， 当 该 代码 返回 时 ， 文 件 被 关 
闭 ， 从 而 将 其 解锁 。 

public static async Task CreateLockedFileAsync(string fileName) 


{ 






























































if (string. IsNulLlLOrWhiteSpace( fileName) ) 
throw new ArgumentNuLLException(nameof (fileName) ); 


FileStream fileStream = null; 
try 
{ 
fileStream = new FileStream(fileName, 
FileMode.Create, 
FileAccess.ReadWrite, 
FileShare.ReadWrite, 4096, useAsync: true); 


using (StreamWriter writer - new StreamWriter(fileStream)) 
{ 

await writer.WriteLineAsync("The First Line"); 

await writer.WriteLineAsync("The Second Line"); 

await writer.FlushAsync(); 


try 
{ » 
// 锁定 整个 文件 
fileStream.Lock(0, fileStream.Length); 


// 执行 一 些 耗 时 的 处 理 
Thread.Sleep( 1000) ; 








} 

finally 

{ 
// 确保 解锁 文件 
// 如 果 一 个 进程 终结 时 仍 有 文件 的 一 部 分 被 锁定 ， 
// 或 者 关闭 一 个 带 有 锁定 的 文件 ,其 行为 是 未 定义 的 
fileStream.Unlock(0, fileStream.Length); 








} 


await writer.WriteLineAsync("The Third Line"); 
fileStream = null; 
} 
} 
finally 


if (fileStream != null) 
fileStream.Dispose(); 


在 CreateLockedFileAsync 中 使 用 了 async 和 await 运算 符 。async 运算 符 允 
许 你 指明 一 个 方法 可 以 在 特定 位 置 暂 停 ，await 运算 符 用 来 指定 这 些 代 码 中 
的 暂停 点 , 这 意味 着 编译 器 知道 async 方法 无 法 继续 执行 到 暂停 点 后 ， 直 到 
await 指定 的 异步 处 理 完 成 。 在 它 等 待 时 ， 调 用 方 获得 控制 权 。 这 有 助 于 你 
的 程序 中 调用 者 的 线程 不 会 阻塞 ， 并 且 可 以 执行 其 他 工作 ， 但 该 方法 的 表现 
仍然 像 是 被 同步 调用 的 。 


























8.5.8 讨论 
如 果 在 你 的 应 用 程序 中 打开 了 一 个 文件 ， 并 且 将 FileStream.0pen 调用 的 FileShare 参数 设 
4 FileShare.Readwrite 或 FiLeShare.Nrite， 那 么 应 用 程序 中 的 其 他 代码 可 以 在 你 使 用 
文件 时 查看 或 改变 文件 的 内 容 。 为 了 以 更 细 的 粒度 处 理 文件 访问 ， 可 使 用 Filestream 对 象 
的 Lock 方法， 防止 其 他 代码 改写 用 户 文件 的 部 分 或 全 部 。 一 旦 完成 对 文件 加 锁 部 分 的 操 
作 ， 就 可 以 调用 FileStream 对 象 的 Unlock 方法 ， 从 而 人 允许 用 户 应 用 程序 中 的 其 他 代码 向 
文件 的 该 部 分 写 入 数据 。 
要 锁定 整个 文件 ， 可 使 用 下 列 语法 。 

fileStream.Lock(0, fileStream.Length) ; 
要 锁定 文件 的 一 部 分 ， 可 使 用 下 列 语法 。 

fileStream.Lock(4, fileStream.Length - 4); 
这 一 行 代码 锁定 除 前 四 个 字符 外 的 整个 文件 。 注 意 ， 可 以 锁定 整个 文件 并 且 仍 然 能 多 次 打 
开 它 ， 也 能 写 人 内 容 。 
如 果 另 一 线程 正在 访问 该 文件 ， 那 么 在 调用 Write、Flush 或 Close 方法 时 ， 可 能 会 看 到 引 
发 一 个 IOException。 例 如 ， 下 面 的 代码 就 容易 产生 这 种 异常 。 
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public static async Task CreateLockedFileWithExceptionAsync(string fileName) 


{ 


FileStream fileStream = null; 
try 
{ 
fileStream = new FileStream(fileName, 
FileMode.Create, 
FileAccess.ReadWrite, 
FileShare.ReadWrite, 4096, useAsync: true); 
using (StreamWriter streamWriter - new StreamWriter(fileStream)) 








{ 
await streamWriter.WriteLineAsync("The First Line"); 
await streamWriter.WriteLineAsync("The Second Line"); 
await streamWriter.FlushAsync(); 
// 锁定 整个 文件 
fileStream.Lock(0, fileStream.Length); 
FileStream writeFileStream - null; 
try 
{ 
writeFileStream = new FileStream(fileName, 
FileMode.Open, 
FileAccess.Write, 
FileShare.ReadWrite, 4096, 
useAsync: true); 
using (StreamWriter streamWriter2 = 
new StreamWriter(writeFileStream)) 
{ 
await streamWriter2.WriteAsync("foo "); 
try 
{ 
streamWriter2.Close(); // --» 此 处 会 发 生 异 党 
} 
catch 
{ 
Console.WriteLine( 
"The streamWriter2.Close call generated an exception."); 
} 
streamWriter.WriteLine("The Third Line"); 
} 
writeFileStream = null; 
} 
finally 
{ 
if (writeFileStream != null) 
writeFileStream.Dispose(); 
} 
} 
fileStream = null; 
} 
finally 
{ 


if (fileStream != null) 
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} 


fileStream.Dispose(); 


该 代码 产生 下 列 输出 。 


The streamWriter2.Close call generated an exception. 


尽管 第 二 个 StreamWriter XR streamWriter2 将 内 容 写 入 一 个 被 锁定 的 文人 





streamWriter2.Close 方法 时 ， 才 会 引发 IOException, 


如 果 将 本 范例 代码 改写 如 下 : 


public static async Task CreateLockedFileWithUnlockAsync(string fileName) 


{ 


FileStream fileStream = null; 


try 
{ 


fileStream = new FileStream(fileName, 


FileMode.Create, 
FileAccess.ReadWrite, 


FileShare.ReadWrite, 4096, useAsync: true); 


using (StreamWriter streamWriter - new StreamWriter(fileStream)) 


{ 


await streamWriter.WriteLineAsync("The First Line"); 
await streamWriter.WriteLineAsync("The Second Line"); 
await streamWriter.FlushAsync(); 


// 锁定 整个 文件 
fileStream.Lock(0, fileStream.Length) ; 


// 尝试 访问 锁定 的 文件 


FileStream writeFileStream = null; 


try 
{ 
writeFileStream = new FileStream(fileName, 
FileMode.Open, 
FileAccess.Write, 
FileShare.ReadWrite, 4096, 
useAsync: true); 
using (StreamWriter streamWriter2 - 
new StreamWriter(writeFileStream)) 
{ 
await streamWriter2.WriteAsync("foo"); 
fileStream.Unlock(0, fileStream.Length); 
await streamWriter2.FlushAsync(); 
} 
writeFileStream = null; 
} 
finally 
{ 
if (writeFileStream != null) 
writeFileStream.Dispose(); 
} 


F， 但 仅 当 执行 
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fileStream = null; 


} 
finally 
if (fileStream != null) 
fileStream.Dispose(); 
} 


} 


则 不 会 引发 任何 异常 。 这 是 因为 该 代码 解锁 了 最 初 锁定 整个 文件 的 FileStream 对 象 。 这 
一 行为 同时 释放 了 FileStream 对 象 所 持 有 文件 上 所 有 的 锁 。 在 示例 中 ，streamWriter2. 
Write("Foo") 方法 已 经 将 Foo 写 入 流 的 缓冲 区 ， 但 尚未 刷新 缓冲 区 ， 因 此 字符 串 Foo 仍然 
等 待 刷新 并 写 入 实际 的 文件 。 当 交错 使 用 流 的 打开 、 锁 定 和 关闭 时 ， 一 定 要 牢记 这 种 情 
况 。 代 码 中 的 错误 有 时 在 代码 审查 、 单 元 测试 和 正式 的 QA 测试 中 没有 马上 被 发 现 ， 这 会 
导致 菜 些 很 难 跟踪 到 的 错误 ， 因 此 在 使 用 文件 锁定 时 要 小 心 对 待 。 


8.5.4 参考 


MSDN 文档 中 的 “StreamWriter 类 ”“FileSystem 类 ”和 “使 用 Async All Await 的 异步 编 
程 ” 主 题 。 


8.6 等 竺 文件 系统 中 的 动作 发 生 


8.6.1 问题 


你 需要 在 文件 系统 中 发 生 一 个 特定 事件 时 得 到 通知 ， 例 如 重 命名 一 个 文件 或 目录 ， 文 件 大 
小 增加 或 减少 ， 删 除 一 个 文件 或 目录 ， 创 建 一 个 文件 或 目录 ， 其 至 修改 一 个 文件 或 目录 的 
属性 。 但 是 ， 这 一 通知 必须 同步 发 生 。 换 而 言 之 ， 应 用 程序 在 指定 行为 出 现在 文件 或 目录 
中 之 前 不 能 继续 运行 。 


8.6.2 解决 方案 


可 调用 FileSystemWatcher 类 的 WaitForChanged 方法 ， 以 便 同 步 等 待 一 个 事件 通知 。 例 8-2 
所 示 的 WaitForZipCreation 方法 举例 说 明了 这 一 点 ， 它 在 继续 执行 下 一 行 WriteLine 语句 
代码 之 前 等 待 一 个 行为 被 执行 ， 更 确切 地 说 ， 是 在 C:\ 驱动 器 上 创建 Backup.zip 文件 的 行 
为 。 最 后 ， 我 们 分 出 一 个 任务 来 执行 创建 文件 的 工作 。 通 过 以 Task 来 执行 创建 文件 操作 ， 
我 们 允许 当 一 个 独立 线程 可 用 时 在 此 线程 上 进行 处 理 ， 并 且 FileSystemWatcher 可 以 检测 
到 文件 创建 。 

例 8-2: WaitForZipCreation 方法 


public static void WaitForZipCreation(string path, string fileName) 


{ 






















































































if (string.IsNullOrWhiteSpace(path)) 
throw new ArgumentNullException(nameof(path)); 
if (string.IsNullOrWhiteSpace(fileName)) 
throw new ArgumentNullException(nameof(fileName)); 
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FileSystemWatcher fsw = null; 
try 
{ 
fsw = new FileSystemWatcher(); 
string [] data = new string[] {path, fileName}; 
fsw.Path = path; 
fsw.Filter = fileName; 
fsw.NotifyFilter = NotifyFilters.LastAccess | NotifyFilters.LastWrite 
| NotifyFilters.FileName | NotifyFilters.DirectoryName; 


// 运行 此 代码 以 生成 监控 的 文件 
// 通常 并 不 需要 这 样 做 ,因为 另 一 个 源 正 在 创建 文 付 
Task work = Task.Run(() => 








T 

















v 

















{ 
try 
{ 
// 等 待 1 秒 
Thread.Sleep(1000); 
// 在 临时 目录 中 创建 文件 
if (data.Length == 2) 
{ 
string dataPath = data[0]; 
string dataFile = path + data[1]; 
Console.WriteLine($"Creating {dataFile} in task..."); 
FileStream fileStream = File.Create(dataFile); 
fileStream.Close(); 
} 
} 
catch (Exception e) 
{ 
Console.WriteLine(e.ToString()); 
} 
35 


// 不 必 等 待 work 任 务 完成 
// 因为 我 们 通过 FiLeSystemWatcher 检 测 文 件 创建 
WaitForChangedResult result = 
fsw.WaitForChanged(WatcherChangeTypes.Created) ; 
Console.WriteLine($"{result.Name} created at {path}."); 

















} 

catch(Exception e) 

{ 
Console.WriteLine(e.ToString()); 

} 

finally 

{ » 
// 清理 
File.Delete(fileName); 
fsw?.Dispose(); 

} 
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8.6.3 讨论 

WaitForChanged 方法 返回 一 个 包含 表 8-1 中 所 列 属性 的 WaitForChangedResult 结构 体 。 

表 8-1: WaitForChangedResult 属 性 

属 性 Ho R 

ChangeType —— 列 出 发 生 的 改变 类 型 。 这 种 改变 作为 一 个 WatcherChangeTypes 枚 举 被 返回 。 该 枚 举 的 值 可 
被 组 合 求 或 

Name 持 有 发 生 改 变 的 文件 或 目录 名 。 如 果 文 件 或 目录 被 重 命名 ， 那 么 该 属性 返回 被 修改 后 的 名 
称 。 如 果 方 法 调用 超时 ， 则 会 将 其 值 设置 为 null 

OldName 被 改变 的 文件 或 目录 的 初始 名 。 如 果 该 文件 或 目录 未 被 重 命 名 ， 那 么 该 属性 将 返回 与 Name 
属性 相同 的 值 。 如 果 方 法 调用 超时 ， 则 会 将 其 值 设置 为 nutl 

TimedOut 持 有 表示 WattForChanged 方法 超时 的 布尔 值 ， 超 时 则 为 true， 未 超时 则 为 false 


当前 我 们 对 WaitForChanged 的 调用 方式 可 能 会 导致 永远 阻塞 。 为 了 防止 永久 挂 起 
WaitForChanged 调用 ， 可 以 指定 超时 值 为 3 秒 ， 如 下 所 示 。 


WaitForChangedResult result = 
fsw.WaitForChanged(WatcherChangeTypes.Created, 3000); 


NotifyFilters 枚 举人 允许 指定 等 待 的 文件 或 文件 夹 的 类 型 ， 如 表 8-2 所 示 。 
表 8-2: NotifyFilters 榴 举 

枚 举 值 E X 

FileName 文件 名 

DirectoryName ”目录 名 

Attributes 文件 或 文件 夹 属性 

Size 文件 或 文件 夹 大 小 

LastWrite 文件 或 文件 夹 被 写 人 内 容 的 最 后 日 期 
LastAccess 文件 或 文件 夹 最 后 被 访问 的 日 期 
CreationTime 文件 或 文件 夹 创 建 的 时 间 

Security 文件 或 文件 夹 的 安全 设置 


8.6.4 参考 


MSDN 文档 中 的 “FilesystemWatcher 2& " *NotifyFilters 枚 举 ” 和 “WaitForChanged- 
Result 结构 ”主题 


8.7 比较 两 个 可 执行 模块 的 版 本 信息 


8.7.1 问题 


你 需要 编程 比较 两 个 可 执 和 a EE em eine 行 代码 的 文 
件 ， 如 .exe 或 .dl 文件。 比较 两 个 可 执行 模块 版 本 信息 的 能 力 对 以 下 几 种 情景 中 的 应 用 程 















































































































































序 非 常 有 用 。 

。 试图 确定 它 是 否 具有 要 执行 的 所 有 “正确 ”片段 。 

。 确定 一 个 通过 反射 动态 加 载 的 程序 集 。 

。 查找 散布 在 本 地 文件 系统 或 网 络 的 众多 文件 中 某 个 文件 或 .dll 的 最 新 版 本 。 


8.7.2 解决 方案 





使 用 CompareFileVersions 方法 比较 可 执行 模块 的 版 本 信息 。 该 方法 接受 两 个 文件 名 作 





为 参数 ， 包 括 它 们 的 路 径 。 每 个 模块 的 版 本 信息 被 获取 并 进行 比较 。 该 方法 返回 





FileComparison 枚 举 ， 其 定义 如 下 所 示 。 


public enum FileComparison 


{ 
Error = 0, 
Newer = 1, 
Older = 2, 
Same = 3 

} 


CompareFileVersions 方法 的 代码 如 例 8-3 所 示 。 


例 8-3: CompareFileVersions 方法 
private static FileComparison ComparePart(int p1, int p2) => 


p1 > p2 ? FileComparison.Newer : 
(pl < p2 ? FileComparison.Older : FileComparison. Same) ; 


public static FileComparison CompareFileVersions(string file1, string file2) 
{ 
if (string. IsNullOrWhiteSpace( filet) ) 
throw new ArgumentNullException(nameof(file1)); 
if (string.IsNullOrWhiteSpace(file2)) 
throw new ArgumentNullException(nameof(file2)); 


FileComparison retValue = FileComparison.Error; 

// 获取 版 本 信息 

FileVersionInfo file1Version = FileVersionInfo.GetVersionInfo(file1); 
FileVersionInfo file2Version = FileVersionInfo.GetVersionInfo(file2); 


retValue = ComparePart(fileiVersion.FileMajorPart, 
file2Version.FileMajorPart); 


一 个 


if (retValue != FileComparison. Same) 

{ 
retValue = ComparePart(fileiVersion.FileMinorPart, file2Version.FileMinorPart); 
if (retValue != FileComparison. Same) 
{ 


retValue = ComparePart(file1Version.FileBuildPart, 
file2Version.FileBuildPart); 
if (retValue !- FileComparison.Same) 
retValue = ComparePart(fileiVersion.FilePrivatePart, 
file2Version.FilePrivatePart); 
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return retValue; 


j 


8.7.8 讨论 
并 非 所 有 的 可 执行 模块 都 有 版 本 信息 。 如 果 使 用 FileVersionInfo 类 加 载 了 一 个 没有 版 本 
信息 的 模块 ， 并 不 会 引起 异常 ， 返 回 的 对 象 引 用 也 不 会 被 设 为 nutll。 相 反 ， 你 会 得 到 一 
个 合法 的 FileVersionInfo 对 象 ， 其 数据 成 员 处 于 初始 状态 ， 对 于 .NET 对 象 来 说 也 就 是 
null, 
程序 集 实际 上 有 两 个 版 本 信息 集 ， 程 序 集 清单 中 的 版 本 信息 和 PE (可 移植 可 执行 文件 ) 
文件 版 本 信息 。FileVersionInfo 读 取 程序 集 清单 中 的 版 本 信息 。 
该 方法 的 第 一 个 动作 是 确定 传递 入 filel fü file2 参数 的 文件 是 否 实际 存在 。 如 果 存 在 ， 
调用 FileVersionInfo 类 的 GetVersionInfo 静态 方法 去 得 到 两 个 文件 的 版 本 信息 。 
CompareFileVersions 方法 通过 使 用 由 GetVersionInfo 返回 的 FileVersionInfo 对 象 的 以 下 
儿 个 属性 ， 试 图 比较 文件 版 本 号 的 每 个 部 分 。 
。 FileMajorPart 

版 本 号 的 前 2 575 
e FileMinorPart 

版 本 号 的 第 3、4 Ft 
e FileBuildPart 

版 本 号 的 第 5、6 字 节 
e FilePrivatePart 

版 本 号 的 最 后 2 5678 
完整 的 版 本 号 由 四 部 分 组 成 ， 构 成 一 个 代表 文件 版 本 号 的 8 字 市 数字 。 
CompareFileVersions 方法 首先 比较 两 个 文件 的 FileMajorPart 版 本 信息 。 如 果 两 者 相等 ， 
那么 比较 两 个 文件 的 FileMinorPart 版 本 信息 。 这 一 过 程 继 续 比 较 FileBuildPart, ia 
比较 FilePrivatePart 版 本 信息 值 。 如 果 所 有 四 个 部 分 都 相等 ， 那 么 文件 被 认为 是 具有 相 
同 的 版 本 号 。 如 果 发 现 一 个 文件 有 着 比 另 一 个 文件 更 高 的 版 本 号 ， 那 么 就 认为 它 是 最 近 的 
版 本 。 


8.7.4 ”参考 
MSDN 文档 中 的 “FileVersionInfo 类 ”主题 。 
















































































8.8 查询 系统 上 所 有 驱动 器 的 信息 


8.8.1 问题 


你 的 应 用 程序 需要 知道 一 个 驱动 器 (HDD, CD 驱动 器 、DVD 驱动 器 、 蓝 光驱 动 器 等 ) 是 








否 可 用 并 且 是 否 写 和 或 读 出 就 结 ， 以 及 驱动 器 上 是否 拥 有 足够 的 可 用 空 亲 空间 。 





8.8.2 解决 方案 
使 用 DriveInfo 类 的 各 种 属性 ， 如 下 所 示 。 


public static void DisplayAllDriveInfo() 





{ 
DriveInfo[] drives = DriveInfo.GetDrives(); 
Array.ForEach(drives, drive => 
{ 
if (drive. IsReady) 
{ 
Console.WriteLine($"Drive {drive.Name} is ready."); 
Console.WriteLine($"AvailableFreeSpace: {drive.AvailableFreeSpace}"); 
Console.WriteLine($"DriveFormat: {drive.DriveFormat}"); 
Console.WriteLine($"DriveType: {drive.DriveType}"); 
Console.WriteLine($"Name: {drive.Name}"); 
Console.WriteLine("RootDirectory.FullName: " + 
$"(drive.RootDirectory.FullName]"); 
Console.WriteLine($"TotalFreeSpace: {drive.TotalFreeSpace}"); 
Console.WriteLine($"TotalSize: {drive.TotalSize}"); 
Console.WriteLine($"VolumeLabel: {drive.VolumeLabel}"); 
} 
else 
{ 
Console.WriteLine($"Drive {drive.Name} is not ready."); 
} 
Console.WriteLine(); 
35 
} 








每 个 系统 可 能 会 不 同 ， 因 而 结果 有 异 ， 但 该 代码 将 显示 类 似 下 列 格式 的 内 容 。 


Drive C:\ is ready. 
AvailableFreeSpace: 143210795008 
DriveFormat: NTFS 

DriveType: Fixed 

Name: C:\ 
RootDirectory.FullName: C:\ 
TotalFreeSpace: 143210795008 
TotalSize: 159989886976 
VolumeLabel: Vol1 


Drive D:\ is ready. 
AvailableFreeSpace: 0 
DriveFormat: UDF 
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DriveType: CDRom 

Name: D:\ 
RootDirectory.FullName: D:\ 
TotalFreeSpace: 0 
TotalSize: 3305965568 
VolumeLabel: Vol2 


Drive E:\ is ready. 
AvailableFreeSpace: 4649025536 
DriveFormat: UDF 

DriveType: CDRom 

Name: E:\ 
RootDirectory.FullName: E:\ 
TotalFreeSpace: 4649025536 
TotalSize: 4691197952 
VolumeLabel: Vol3 


Drive F:\ is not ready 


IsReady 和 AvailableFreeSpace 属性 特别 引 人 注 意 。IsReady 属性 确定 驱动 器 是 否 准备 好 
被 查询 、 写 入 或 读 出 ， 但 并 不 十 分 可 靠 ， 因 为 其 状态 可 能 很 快 就 会 发 生变 化 。 如 果 使 用 
IsReady， 那 么 要 确保 解决 驱动 器 尚未 就 绪 这 种 情况 。AvailableFreeSpace 属性 按 字 节 返回 
驱动 器 上 的 空 闪 空间 。 


8.8.3 讨论 


NET Framework 中 的 DriveInfo 类 人 允许 简单 地 查询 系统 中 某 个 特定 驱动 器 或 者 所 有 驱动 器 
上 的 信息 。 要 查询 单个 驱动 器 的 信息 ， 可 以 使 用 如 例 8-4 所 示 的 代码 。 


例 8-4: 获得 特定 驱动 器 的 信息 
DriveInfo drive = new DriveInfo("D"); 
if (drive.IsReady) 
Console.WriteLine($"The space available on the D:\\ drive: " + 
$"(drive.AvailableFreeSpace]"); 






































else 
Console.WriteLine("Drive D:\\ is not ready."); 


我 们 注意 到 ， 只 有 驱动 器 名 被 传递 给 Drivelnfo 构造 国 数 。 驱 动 器 名 可 以 是 大 写 ， 也 可 
以 是 小 写 ， 这 无 关 紧 要 。 在 8.8.2 节 的 代码 中 ， 你 注意 到 的 下 一 件 事 是 IsReady 属性 在 使 
用 驱动 器 或 查询 其 属性 之 前 都 被 检测 其 值 是 否 为 true。 如 果 未 对 该 属性 进行 true 值 的 测 
试 ， 并 且 由 于 某 种 原因 驱动 器 未 就 绪 (例如 ， 那 时 该 CD 没有 放 进 驱动 器 中 )， 那 么 将 会 
返回 一 个 声明 “The device is not ready" HJ System.I0.IOException。 本 范例 的 解决 方案 中 
未 使 用 DriveInfo 的 构造 国 数 ， 而 是 使 用 DriveInfo 类 的 静态 方法 GetDrives 以 返回 一 个 
DriveInfo 对 象 数组 。 该 数组 中 的 每 个 DriveInfo 对 象 对 应 于 当前 系统 中 的 一 个 驱动 器 。 


DriveInfo 类 的 DriveType 属性 返回 一 个 DriveType 枚 举 类 型 的 枚 举 值 。 该 枚 举 值 确定 当前 
DriveInfo 对 象 代表 的 驱动 器 类 型 。 表 8-3 列 出 了 DriveType 枚 举 的 不 同 值 。 






































588-3: DriveType 枚 举 值 





















































枚 举 值 描 x 

CDRom 可 以 是 一 个 CD-ROM, CD 刻录 器 、DVD-ROM、DYVD 或 蓝光 刻录 驱动 器 

Fixed 一 个 国定 驱动 器 ， 例 如 HDD。 要 注意 ，USB HDD 被 归于 此 类 

Network 一 个 网 络 驱 动 器 

NoRootDirectory ”该 驱动 器 上 未 发 现 根 目录 

Ram 一 个 RAM 磁盘 

Removable 一 个 可 移 除 的 存储 设备 

DriveInfo 类 有 两 个 非常 相似 的 属性 : AvailableFreeSpace 和 TotalFreeSpace。 这 两 个 属性 


在 大 多 数 情况 下 返回 相同 的 值 ， 但 Available 


























找到 磁盘 配额 信息 。 这 一 操作 会 显示 该 驱动 器 





击 “ 配 额 ”选项 卡 可 查看 该 驱动 器 的 配额 信息 。 








FreeSpace 还 考虑 到 某 个 特定 驱动 器 的 磁盘 配 








额 信 息 。 在 Windows 资源 管理 器 中 可 通过 右 击 一 个 驱动 器 然后 选择 “属性 ”弹出 菜单 项 来 














的 “属性 ”页 面 。 在 该 “属性 ”页 面 中 ， 单 
如 果 “启用 配额 管理 ” 复 选 框 未 选中 ， 则 














磁盘 配额 管理 被 禁用 ， 并 且 AvailableFreeSpace 和 TotalFreeSpace 属性 值 应 当 是 相等 的 。 


8.8.4 参考 


MSDN 文档 中 的 “DriveInfo 类 ”主题 。 


8.9 压缩 和 解压 缩 文件 


8.9.1 问题 




















你 需要 一 种 使 用 一 个 基于 流 的 类 来 压缩 文件 的 方法 ， 并 且 不 受 Framework 类 施加 的 4 GB 
限制 。 此 外 还 需要 一 种 解压 缩 文件 的 方法 ， 使 得 你 能 够 读 回 文件 内 容 。 





8.9.2 解决 方案 


使 用 System.I0.Compression.DefLateStream 或 System.IO.Compression.GZipStream 类 ， 通 
过 使 用 一 个 “数据 块 化 ”的 例 程 来 读 取 压缩 过 的 数据 并 将 其 写 入 一 个 文件 。 例 8-5 显示 的 
CompressFileAsync、DecompressFileAsync 和 Decompress 方法 举例 说 明了 如 何 使 用 这 些 类 


即时 地 压缩 和 解压 缩 文 件 。 




















例 8-5: CompressFileAsync 和 DecompressFileAsync 方法 


/// <summary> 

/// 将 源 文件 压缩 到 目标 文件 。 
/// 通过 使 用 1 MB 的 数据 块 来 完成 这 一 操作 ， 
/// </summary> 

/// «param name="sourceFiLe"> 未 压缩 的 文 








3 





从 而 不 会 溢出 内 存 使 用 





件 </param> 


/// «param name="destinationFile"> 压 缩 过 的 文件 </param> 





/// «param name="compressionType"> 要 使 月 
public static async Task CompressFileAs 





目的 压缩 类 型 </param> 


ync(string sourceFile, 
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string destinationFile, 
CompressionType compressionType) 


if (string. IsNullOrWhiteSpace(sourceFile) ) 
throw new ArgumentNullException(nameof(sourceFile)); 


if (string.IsNullOrWhiteSpace(destinationFile)) 
throw new ArgumentNullException(nameof(destinationFile)); 


FileStream streamSource - null; 
FileStream streamDestination - null; 
Stream streamCompressed - null; 


int bufferSize - 4096; 

using (streamSource - new FileStream(sourceFile, 
FileMode.OpenOrCreate, FileAccess.Read, FileShare.None, 
bufferSize, useAsync: true)) 


using (streamDestination - new FileStream(destinationFile, 
FileMode.OpenOrCreate, FileAccess.Write, FileShare.None, 
bufferSize, useAsync: true)) 





// 读 取 1 MB 的 数据 块 并 将 其 压缩 


long fileLength = streamSource.Length; 








// 写 出 ftLeLength 的 大 小 
byte[] size = BitConverter.GetBytes(fileLength) ; 
await streamDestination.WriteAsync(size, 0, size.Length); 


long chunkSize = 1048576; // 1 MB 
while (fileLength > 0) 
{ 





/] 读 取 数据 块 
byte[] data = new byte[chunkSize]; 
await streamSource.ReadAsync(data, 0, data.Length); 





// 压缩 数据 块 
MemoryStream compressedDataStream = 
new MemoryStream(); 





if (compressionType == CompressionType.Deflate) 
streamCompressed = 
new DeflateStream(compressedDataStream, 
CompressionMode.Compress); 
else 
streamCompressed - 
new GZipStream(compressedDataStream, 
CompressionMode.Compress); 


using (streamCompressed) 


// 将 数据 块 写 入 压缩 数据 流 


await streamCompressed.WriteAsync(data, 0, data.Length); 


} 
// 获取 压缩 数据 块 的 字 节 数 








byte[] compressedData = 
compressedDataStream.GetBuffer(); 





// 写 出 数据 块 大 小 
size = BitConverter.GetBytes(chunkSize) ; 
await streamDestination.WriteAsync(size, 0, size.Length); 





// 写 出 压缩 过 的 大 小 
size = BitConverter.GetBytes(compressedData.Length); 
await streamDestination.WriteAsync(size, 0, size.Length); 











// 写 出 压缩 数据 块 
await streamDestination.WriteAsync(compressedData, 0, 
compressedData.Length); 


// 从 文件 大 小 中 减 去 数据 块 大 小 
fileLength -= chunkSize; 








// 如 果 剩 余 文 件 大 小 小 于 数据 块 大 小 ,使 用 剩余 文件 大 小 
if (fileLength < chunkSize) 
chunkSize = fileLength; 





} 


/// <summary> 

/// Werk cr fe Hei ct CompressFileAsync rh Zi GU RE WIR Hs Zr] c PF 

/// </summary> 

/// «param name="sourceFiLe"> 压 缩 文件 </param> 

/// <param name="destinationFiLe"> 目 标 文件 </param> 

/// <param name="compressionType"> 要 使 用 的 压缩 类 型 </param> 

public static async Task DecompressFileAsync(string sourceFile, 
string destinationFile, 
CompressionType compressionType) 














if (string. IsNuLlOrWhiteSpace(sourceFile) ) 
throw new ArgumentNullException(nameof(sourceFile)); 
if (string.IsNullOrWhiteSpace(destinationFile)) 
throw new ArgumentNullException(nameof(destinationFile)); 


FileStream streamSource - null; 
FileStream streamDestination - null; 
Stream streamUncompressed - null; 


int bufferSize - 4096; 

using (streamSource - new FileStream(sourceFile, 
FileMode.OpenOrCreate, FileAccess.Read, FileShare.None, 
bufferSize, useAsync: true)) 


using (streamDestination - new FileStream(destinationFile, 


FileMode.OpenOrCreate, FileAccess.Write, FileShare.None, 
bufferSize, useAsync: true)) 


// 读 取 fileLength 大 小 
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// 读 取 块 大 小 

byte[] size = new byte[sizeof(long)]; 

await streamSource.ReadAsync(size, 0, size.Length); 

// 将 size 转 换 回 数值 

long fileLength = BitConverter.ToInt64(size, 0); 

long chunkSize = 0; 

int storedSize = 0; 

long workingSet = Process.GetCurrentProcess().WorkingSet64; 
while (fileLength > 0) 

{ 





// 读 取 块 大 小 
size = new byte[sizeof(long)]; 
await streamSource.ReadAsync(size, 0, size.Length); 
// 将 size 转 换 回 数值 
chunkSize = BitConverter.ToInt64(size, 0); 
if (chunkSize > fileLength || 
chunkSize > workingSet) 
throw new InvalidDataException(); 








Ln 








// 读 取 压缩 过 的 块 大 小 
size = new byte[sizeof(int)]; 
await streamSource.ReadAsync(size, 0, size.Length); 
// 将 size 转 换 回 数值 
storedSize = BitConverter.ToInt32(size, 0); 
if (storedSize > fileLength || 
storedSize > workingSet) 
throw new InvalidDataException(); 











Ln 








if (storedSize » chunkSize) 
throw new InvalidDataException(); 


byte[] uncompressedData - new byte[chunkSize]; 

byte[] compressedData - new byte[storedSize]; 

await streamSource.ReadAsync(compressedData, 0, 
compressedData.Length); 


|] 解压 缩 数 据 块 
MemoryStream uncompressedDataStream = 
new MemoryStream(compressedData); 





if (compressionType == CompressionType.Deflate) 
streamUncompressed = 
new DeflateStream(uncompressedDataStream, 
CompressionMode.Decompress) ; 
else 
streamUncompressed = 
new GZipStream(uncompressedDataStream, 
CompressionMode.Decompress); 


using (streamUncompressed) 


// 读 取 压缩 数据 流 中 的 数据 块 
await streamUncompressed.ReadAsync(uncompressedData, 0, 
uncompressedData.Length) ; 














// 写 出 未 压缩 过 的 数据 块 
await streamDestination.WriteAsync(uncompressedData, 0, 
uncompressedData.Length); 





// 从 文件 大 小 中 减 去 数据 块 大 小 
fileLength -= chunkSize; 





// 如 果 剩 余 文 件 大 小 小 于 数据 块 大 小 ,使 用 剩余 文件 大 小 
if (fileLength < chunkSize) 
chunkSize = fileLength; 





} 


CompressionType 枚 举 定 义 如 下 所 示 。 


public enum CompressionType 


{ 
Deflate, 
GZip 


8.9.3 讨论 


CompressFileAsync 方法 接受 一 个 指向 要 压缩 的 源 文 件 的 路 径 、 一 个 指向 被 压缩 文件 目的 地 
的 路 径 以 及 一 个 指示 使 用 哪 种 压缩 算法 (Deflate 或 GZip) 的 CompressionType 枚 举 值 。 该 
方法 生成 一 个 包含 了 压缩 数据 的 文件 。 

DecompressFileAsync 方法 接受 一 个 指向 要 解压 缩 的 源 压 缩 文 件 的 路 径 ， 一 个 指向 解压 缩 文 
件 目的 地 的 路 径 以 及 一 个 指示 使 用 哪 种 解压 缩 算法 (Deflate 或 GZip) 的 CompressionType 
BME . 


例 8-6 所 示 的 TestCompressNewFileAsync 方法 运用 了 8.9.2 节 中 定义 的 CompressFileAsync 
和 DecompressFileAsync 方法 。 























例 8-6: 使 用 CompressFileAsync 和 DecompressFileAsync 方法 
public static async void TestCompressNewFileAsync() 


byte[] data = new byte[10000000]; 
for (int i = 0; i < 10000000; i++) 
data[i] = (byte)i; 


using(FileStream fs = 
new FileStream(@"C:\NewNormalFile.txt", 
FileMode.OpenOrCreate, FileAccess.ReadWrite, FileShare.None, 
4096, useAsync:true)) 


await fs.WriteAsync(data, 0, data.Length); 
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await CompressFileAsync(@"C:\NewNormalFile.txt", @"C:\NewCompressedFile.txt", 
CompressionType.Def Late) ; 


await DecompressFileAsync(@"C: \NewCompressedFile. txt", 
@"C:\NewDecompressedFile.txt", 
CompressionType.Def late) ; 


await CompressFileAsync(@"C:\NewNormalFile.txt", @"C:\NewGZCompressedFile.txt", 
CompressionType.GZip); 


await DecompressFileAsync(@"C:\NewGZCompressedFile. txt", 
@"C:\NewGZDecompressedFile.txt", 
CompressionType.GZip) ; 


// 正常 文件 大 小 == 10 000 00077; 

// Gzip 压缩 文件 大 小 == 84 362 

// DeflLate 压 缩 文件 大 小 == 42 145 

// .NET 4.5 之 前 版 本 Gzip 压缩 文件 大 小 == 155 204 
// -NET 4.5 之 前 版 本 DefLate 压 缩 文件 大 小 == 155 168 
// 36 字 节 数 据 与 GZip 算 法 的 CRC 有 关 














当 此 测试 代码 运行 时 ， 我 们 将 得 到 三 个 大 小 不 一 的 文件 。 第 一 个 文件 NewNormalFile. 
txt 的 大 小 是 10 000 000 字 节 。NewCompressedFile.txt 文件 为 42 145 字 节 ， 最 后 一 个 文件 
NewGzCompressedFile.txt 为 84 362 字 节 。 如 你 所 见 ， 使 用 Def lateStream 类 和 GZipStream 
类 压缩 的 文件 大 小 之 间 并 没有 太 大 差异 ， 其 原因 是 这 两 种 压缩 类 使 用 相同 的 压缩 /解压 缩 
算法 (HI RFC 1951: Deflate 1.3 规范 中 描述 的 无 损 Deflate 算法 )。 


在 .NET 4.5 中 更 新 过 的 GZipStream 和 Def latestream 类 使 用 zlib library (http://www. 
zlib.net/) 来 执行 压缩 ， 这 个 库 提 高 了 压缩 比 。 如 果 在 之 前 版 本 的 .NET Framework 上 运行 
例 8-7 所 示 的 旧版 本 CompressFile 和 DecompressFile 方法 ， 你 可 以 看 到 这 一 对 比 。 


例 8-7: 用 于 .NET 4.5 之 前 版 本 的 CompressFile 和 DecompressFile 方法 





Il 
Il 
Il 
Il 
Il 
Il 
IH 























<summary> 
将 源 文件 压缩 到 目标 文件 。 

通过 使 用 1 MB 的 数据 块 来 完成 这 一 操作 ,从 而 不 会 溢出 内 存 使 用 
</summary> 

«param name="sourceFiLe"> 未 压缩 的 文件 </param> 

«param name="destinationFiLe"> 压 缩 过 的 文件 </param> 
«param name="compressionType"> 要 使 用 的 压缩 类 型 </param> 












































public static void CompressFile(string sourceFile, 


string destinationFile, 
CompressionType compressionType) 


if (sourceFile != null) 

{ 
FileStream streamSource = null; 
FileStream streamDestination = null; 
Stream streamCompressed = null; 


using (streamSource = File.OpenRead(sourceFile)) 


{ 


using (streamDestination = File.OpenWrite(destinationFile)) 
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// 读 取 1 MB 的 数据 块 并 将 其 压缩 


long fileLength = streamSource.Length; 








// 写 出 fileLength 的 大 小 
byte[] size = BitConverter.GetBytes(fileLength); 
streamDestination.Write(size, 0, size.Length); 


long chunkSize = 1048576; // 1 MB 
while (fileLength > 0) 


( 





// 读 取 数 据 块 
byte[] data = new byte[chunkSize]; 
streamSource.Read(data, 0, data.Length); 





// 压缩 数据 块 
MemoryStream compressedDataStream = 
new MemoryStream(); 





if (compressionType == CompressionType.Deflate) 
streamCompressed = 
new DeflateStream(compressedDataStream, 
CompressionMode.Compress); 
else 
streamCompressed = 
new GZipStream(compressedDataStream, 
CompressionMode.Compress); 


using (streamCompressed) 


// 将 数据 块 写 入 压缩 数据 流 


streamCompressed.Write(data, 0, data.Length); 





} 

// 获取 压缩 数据 块 的 字 节 数 

byte[] compressedData = 
compressedDataStream.GetBuffer(); 











// 写 出 数据 块 大 小 
size = BitConverter.GetBytes(chunkSize); 
streamDestination.Write(size, 0, size.Length); 








// 写 出 压缩 过 的 大 小 
size = BitConverter.GetBytes(compressedData.Length); 
streamDestination.Write(size, 0, size.Length); 








// 写 出 压缩 数据 块 
streamDestination.Write(compressedData, 0, 
compressedData.Length) ; 








// 从 文件 大 小 中 减 去 数据 块 大 小 
fileLength -= chunkSize; 








// 如 果 剩 余 文 件 大 小 小 于 数据 块 大 小 ,使 用 剩余 文件 大 小 
if (fileLength < chunkSize) 
chunkSize = fileLength; 
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/// <summary> 

/// 此 函数 将 解压 通过 CompressFiLeAsync 国 数 创 建 的 块 压缩 的 文件 

/// </summary> 

/// «param name="sourceFiLe"> 压 缩 文件 </param> 

/// «param name="destinationFile"> 目 标 文件 </param> 

/// <param name="compressionType"> 要 使 用 的 压缩 类 型 </param> 

public static void DecompressFile(string sourceFile, 
string destinationFile, 
CompressionType compressionType) 




















FileStream streamSource = null; 
FileStream streamDestination = null; 
Stream streamUncompressed = null; 


using (streamSource = File.OpenRead(sourceFile) ) 


{ 


using (streamDestination = File.OpenWrite(destinationFile)) 


{ 





// 读 取 fileLength 大 小 

// 读 取 块 大 小 

byte[] size = new byte[sizeof(long)]; 
streamSource.Read(size, 0, size.Length); 

// 将 size 转 换 回 数值 

long fileLength = BitConverter.ToInt64(size, 0); 
long chunkSize = 0; 

int storedSize = 0; 

long workingSet = Process.GetCurrentProcess().WorkingSet64; 
while (fileLength > 0) 

{ 














// 读 取 块 大 小 
size = new byte[sizeof(long)]; 
streamSource.Read(size, 0, size.Length); 
// 将 size 转 换 回 数值 
chunkSize = BitConverter.ToInt64(size, 0); 
if (chunkSize > fileLength | | 

chunkSize > workingSet) 

throw new InvalidDataException(); 








LL 








// 读 取 压缩 过 的 块 大 小 
size = new byte[sizeof(int)]; 
streamSource.Read(size, 0, size.Length); 
// 将 size 转 换 回 数值 
storedSize = BitConverter.ToInt32(size, 0); 
if (storedSize > fileLength || 

storedSize > workingSet) 

throw new InvalidDataException(); 











L 








if (storedSize » chunkSize) 
throw new InvalidDataException(); 





} 


你 可 能 会 感到 奇怪 : 


byte[] uncompressedData = new byte[chunkSize]; 

byte[] compressedData = new byte[storedSize]; 

streamSource.Read(compressedData, 0, 
compressedData.Length); 


|] 解压 缩 数 据 块 
MemoryStream uncompressedDataStream = 
new MemoryStream(compressedData); 





if (compressionType == CompressionType.Deflate) 
streamUncompressed = 
new DeflateStream(uncompressedDataStream, 
CompressionMode.Decompress); 
else 
streamUncompressed = 
new GZipStream(uncompressedDataStream, 
CompressionMode.Decompress); 


using (streamUncompressed) 














{ 
// 读 取 压缩 数据 流 中 的 数据 块 
streamUncompressed.Read(uncompressedData, 0, 
uncompressedData.Length) ; 
} 





// 写 出 未 压缩 过 的 数据 块 
streamDestination.Write(uncompressedData, 0, 
uncompressedData. Length) ; 


// 从 文件 大 小 中 减 去 数据 块 大 小 
fileLength -= chunkSize; 





// 如 果 剩 余 文 件 大 小 小 于 数据 块 大 小 ,使 用 剩余 文件 大 小 
if (fileLength < chunkSize) 
chunkSize = fileLength; 








如 果 它 们 使 用 相同 的 算法 ， 那 为 什么 选择 某 一 个 类 而 不 是 另 一 个 类 ? 





一 个 非常 好 的 理由 是 ，Gzipstrean 类 为 压缩 过 的 数据 添加 了 一 个 CRC 〈 循 环 元 余 校 验 )， 





以 确定 它 是 否 损坏 。 


如 果 数 据 损坏 ， 则 会 引发 一 个 InvalidDataException 异常 ， 带 有 The 





CRC in GZip footer does not match the CRC calculated from the decompressed data 的 表达 。 通 





过 捕获 这 一 异常 ， 就 可 以 确定 你 的 数据 是 否 已 损坏 。 





// 读 取 块 大 小 


在 Decompess 方法 中 ， 可 能 会 引发 某 些 InvalidDataException 实例 。 


size = new byte[sizeof(long)]; 
streamSource.Read(size, 0, size.Length); 


// 将 size 转 换 回 





数值 


chunkSize = BitConverter.ToInt64(size, 0); 
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if (chunkSize > fileLength || chunkSize > workingSet) 
throw new InvalidDataException(); 


// 读 取 压缩 过 的 块 大 小 

size = new byte[sizeof(int)]; 

streamSource.Read(size, 0, size.Length); 

// 将 size 转 换 回 数值 

storedSize = BitConverter.ToInt32(size, 0); 

if (storedSize > fileLength || storedSize > workingSet) 
throw new InvalidDataException(); 

if (storedSize > chunkSize) 
throw new InvalidDataException(); 

















byte[] uncompressedData = new byte[chunkSize]; 
byte[] compressedData = new byte[storedSize]; 


该 代码 读 取 可 能 已 经 被 自 改 的 缓冲 区 中 的 数据 ， 因 此 需要 进行 检查 ， 这 不 仅 是 日 











TE, Ht PRAT TANIA HE. KA Decompress 将 根据 从 缓冲 区 中 读 取 的 数值 进行 实际 的 
内 存 分 配 ， 所 以 需要 小 心 检 查 这 些 数值 ， 而 且 我 们 不 想 在 无 意 中 引 入 已 被 注入 到 流 中 的 其 


























他 代码 。 此 处 进行 的 基本 检查 是 为 了 确保 以 下 事项 。 
。 数据 块 的 大 小 不 大 于 文件 长 度 。 

。 数据 块 的 大 小 不 大 于 当前 程序 的 工作 集 。 

。 压缩 的 数据 块 大 小 不 大 于 文件 长 度 。 

。 压缩 的 数据 块 大 小 不 大 当 于 前 程序 的 工作 集 。 

。 压缩 的 数据 块 大 小 不 大 于 实际 的 数据 块 大 小 。 


8.9.4 ”参考 
MSDN 文档 中 的 “DefLateStream 类 ”和 “GzipSstream 类 ”主题 。 











上 于 稳定 
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9.0 简介 


连接 性 在 解决 方案 中 变 得 比 以 往 更 加 重要 ，.NET Framework 提供 了 多 种 方法 来 帮助 支持 这 
一 需求 。.NET 提供 了 许多 较 低 级 别 的 类 ， 使 其 网 络 编程 比 之 前 的 诸多 环境 更 加 容易 。 有 
大 量 的 功能 可 帮助 你 完成 以 下 几 项 工作 。 


。 建立 网 络 感知 的 应 用 程序 

。 通过 FTP 下 载 文件 

。 发 送 和 接收 HTTP 请 求 

。 直接 使 用 TCP/IP 和 套 接 字 获 得 更 高 程度 的 控制 


在 Microsoft 尚未 提供 托管 类 以 访问 联网 功能 的 领域 中 (例如 WinInet API 所 暴露 的 用 于 互 
联网 连接 设置 的 某 些 方法 ) ， 总 是 可 以 使 用 P/Invoke， 因 此 可 以 使 用 Win32 API 编码 ; 在 
本 章 中 将 会 探讨 此 方法 。 使 用 System. Net 命名 空间 中 可 用 的 所 有 功能 ， 可 以 快速 地 编写 网 
络 应 用 程序 。 


除了 较 低 级 别 的 网 络 支持 ，.NET 也 积 接 迎 合 万 维 网 的 发 展 ， 已 经 对 大 多 数 .NET 开发 人 
员 目 前 在 构建 其 解决 方案 时 遇 到 的 各 种 问题 提供 了 Web 支持 。Web 服务 (基于 REST 和 
基于 SOAP) 被 广泛 应 用 ，ASP.NET 在 Web 应 用 领域 是 主角 之 一 。 由 于 对 处 理 HTML 和 
TCP/IP 名 称 解析 的 一 般 需求 ， 以 及 统一 资源 指示 器 (URI) 和 统一 资源 定位 器 (URL) 应 
用 越 来 越 广泛 ， 开 发 人 员 需 要 工具 来 帮助 自己 全 神 贯 注 于 构建 他 们 能 够 提供 的 最 好 的 Web 
交互 应 用 程序 。 本 章 关 注 涉及 Web 时 出 现 的 某 些 编程 边缘 问题 。 本 章 并 非 Web 服务 或 
ASP.NET 的 教程 ， 而 是 涵盖 了 开发 人 员 可 以 在 ASP.NET 应 用 或 服务 中 使 用 ， 以 及 在 其 他 
基于 C# 且 与 网 络 和 Web 交互 的 应 用 程序 中 使 用 的 一 些 功能 。 
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9.1 处 理 Web 服 务 器 错误 


9.1.1 问题 


你 获得 了 一 个 来 自 Web 服务 器 的 响应 ， 并且 希望 确保 处 理 初 始 请 求 时 没有 发 生 错误 ， 例 如 
连接 失败 、 被 重 定 向 、 超 时 或 证 书 验证 失败 。 你 希望 避免 检查 所 有 不 同 的 可 用 响应 代码 。 


9.1.2 解决 方案 

检查 HttpWebResponse 类 的 StatusCode 属性 以 确定 这 个 StatusCode 属于 哪个 类 别 的 状态 ， 
并 返回 一 个 代码 类 别 的 枚 举 值 (ResponseCategories)。 这 一 技术 允许 使 用 一 种 更 具 普 遍 性 
的 方式 来 处 理 响 应 代码 。 


public static ResponseCategories CategorizeResponse(HttpWebResponse httpResponse) 


{ 























// 为 了 处 理 未 来 在 HttpStatusCode 中 定义 的 更 多 成 功 代码 ， 

// 此 处 我 们 将 检查 "成 功 "代码 范围 ,而 不 是 使 用 HttpStatusCode 枚 举 ， 
// 因为 它 重 载 了 某 些 值 

int statusCode = (int)httpResponse.StatusCode; 

if ((statusCode >= 100) && (statusCode <= 199)) 


{ 





























return ResponseCategories. Informational; 
else if ((statusCode >= 200) && (statusCode <= 299)) 
return ResponseCategories.Success; 
else if ((statusCode >= 300) && (statusCode <= 399)) 
i return ResponseCategories.Redirected; 
us if ((statusCode >= 400) && (statusCode <= 499)) 
{ 


return ResponseCategories.ClientError; 


else if ((statusCode >= 500) && (statusCode <= 599)) 
{ 


} 


return ResponseCategories.Unknown; 


return ResponseCategories.ServerError; 


} 


ResponseCategories 枚 举 的 定义 如 下 所 示 。 


public enum ResponseCategories 




















{ 
Unknown, // 未 知 代 码 (<100 或 >599 ) 
Informational, // 消息 代码 (100<=199 ) 
Success， // 成 功 代 码 (200<=299) 
Redirected, // 重 定 向 代码 (300<=399) 


ClientError, // 客户 端 错误 代码 (400<=499) 
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ServerError // 服务 器 错误 代码 (500<=599) 


9.1.3 讨论 
在 HITP 响应 中 有 着 五 种 不 同 的 状态 类 别 ， 如 表 9-1 所 示 。 
表 9-1: HTTP 响 应 状态 码 的 类 别 








消息 100~199 100~101 
成 功 200~299 200~206 
重 定 问 300~399 300~307 
客户 端 错误 400~499 400-426 
服务 器 错误 500~599 500~505 


Microsoft 在 .NET Framework 中 定义 的 每 个 状态 码 皆 被 赋予 一 个 HttpStatusCode 枚 举 中 的 
枚 举 值 。 这 些 状 态 码 反映 了 当 提 交 一 个 请 求 时 可 能 发 生 的 情况 。Web 服务 器 可 以 自由 返 
回 位 于 可 用 范围 内 的 一 个 状态 码 ， 即 使 是 大 多 数 的 商业 Web 服务 器 尚未 定义 的 值 。 针 对 
HTTP/1.1 的 RFC 2616 中 的 第 10 节 列 出 了 已 定义 的 状态 码 。 

你 想 要 指出 请 求 的 状态 所 属 的 概括 类 别 。 通 过 检查 HttpResponse.StatusCode 属性 ， 将 它 与 
已 定义 的 用 于 HTTP 的 状态 码 范 围 进行 比较 ， 返 回 适 当 的 ResponseCategories 值 可 以 实现 
操作 。 
当 处 理 HttpStatusCode 时 ， 你 会 注意 到 存在 某 些 映射 到 相同 状态 码 值 的 特定 HttpStatusCode 
标志 。 一 个 例子 是 HttpStatusCode.Ambiguous 和 HttpStatusCode.MultipleChoices， 它 们 都 
映射 到 了 HTTP 状态 码 300。 如 果 试 图 在 一 个 关于 HttpStatusCode 的 switch 语句 中 使 用 这 
两 者 ， 将 会 得 到 下 列 错误 ， 因 为 Ct 编译 器 无 法 发 现 其 差异 。 


error CS0152: The label 'case 300:' already occurs in this switch statement. 


914 参考 


(HTTP 权威 指南 》， 英 文 版 由 OReilly 出 版 ，MSDN 文档 中 的 “HttpStatusCode 枚 举 ” 主 
题 ，HTTP/1.1 RFC 2616 第 10 节 “ 状 态 码 ”(http:/tcn/GPNNm ) 。 


9.2 与 Web 服 务 器 通信 


9.2.1 问题 


你 希望 用 GET 或 POST 请 求 的 形式 向 一 个 Web 服务 器 发 送 一 个 请 求 。 向 Web 服务 器 发 送 完 
请 求 后 ， 你 希望 得 到 来 自 Web 服务 器 的 请 求 结果 (响应 )。 
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9.2.2 解决 方案 
结合 使 用 HttpWebRequest 类 与 WebRequest 类 ， 创 建 一 个 请 求 并 发 送 至 一 个 服务 器 。 


获取 资源 的 Uri (统一 资源 标识 符 ， 在 RFC 3986 中 定义 )， 请 求 (GET mk POST) 中 使 用 的 
方法 ， 以 及 要 发 送 的 数据 ( 仅 针对 POST 请 求 )， 并 使 用 这 些 信息 创建 一 个 HttpNebRequest， 
如 例 9-1 所 示 。 


例 9-1: 与 Web 服务 器 通信 
using System.Net; 

using System.IO; 

using System.Text; 


























// GET 重 载 
public static HttpWebRequest GenerateHttpWebRequest(Uri uri) 
{ 
// 创建 初始 请 求 
HttpWebRequest httpRequest = (HttpWebRequest)WebRequest.Create(uri); 
// 返回 请 求 
return httpRequest; 
} 
// POSTER 





public static HttpWebRequest GenerateHttpWebRequest(Uri uri, 


j 


string postData, 
string contentType) 


// 创建 初始 请 求 
HttpWebRequest httpRequest = GenerateHttpWebRequest(uri); 








// 获得 请 求 的 字 节 数组 ,需要 预先 进行 转 义 
byte[] bytes = Encoding.UTF8.GetBytes(postData) ; 


// 设置 要 提交 数据 的 内 容 类 型 

httpRequest.ContentType = contentType; 
//"application/x-www-form-urlencoded"; WFK È 
//"application/json" 对 于 json 数 据 
//"application/xml" 对 于 xmL 数 据 


|] 设置 要 提交 字符 串 的 内 容 长 度 
httpRequest.ContentLength = postData.Length; 


ur 








// 获取 请 求 流 , 并 写 入 发 布 的 数据 
using (Stream requestStream = httpRequest.GetRequestStream()) 


{ 


} 
// 返回 请 求 
return httpRequest; 


requestStream.Write(bytes, 0, bytes.Length); 














一 旦 你 拥有 了 一 个 HttpwebRequest， 就 可 以 发 送 请 求 并 使 用 GetResponse 方法 获得 响应 。 
它 将 新 近 生 成 的 HttpWebRequest 作为 输入 ， 返 回 一 个 HttpWebResponse。 下 列 示 例 针 对 
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http://localhost/mysite 网 站 的 index.aspx 页 面 执行 一 个 GET。 


HttpWebRequest request = 
GenerateHttpWebRequest(new Uri("http://localhost/mysite/index.aspx")); 


using(HttpWebResponse response - (HttpWebResponse) request.GetResponse()) 

















// 下 一 行 代码 使 用 了 范例 9.1( 即 9.1 节 ) 中 的 CategorizeResponse 
if(CategorizeResponse(response)--ResponseCategories.Success) 


{ 


} 
} 


你 生成 HttpNebRequest， 发 送 它 并 得 到 HttpwebResponse， 然 后 使 用 范例 9.1 (BN 9.1 47) 
中 的 CategorizeResponse 方法 以 检查 是 否 成 功 。 


9.2.3 讨论 
WebRequest 和 WebResponse 类 封装 了 执行 基本 Web 通信 的 所 有 功能 。HttpWebRequest 和 
HttpWebResponse 是 从 这 些 类 派生 而 来 的 ， 并 且 提 供 了 特定 的 HTTP 支持 。 


在 最 基础 级 别 上 ， 要 执行 一 个 基于 HTTP 的 Web 事务 ， 可 以 使 用 WebRequest 类 上 的 
Create 方法 获得 一 个 可 类 型 转换 为 HttpWebRequest 的 WebRequest (只 要 模式 是 http:// 或 
https:// 即 可 )。 然 后 在 调用 GetResponse 方法 时 ， 这 个 HttpWebRequest 被 提交 到 相应 的 
Web 服务 器 ， 并 且 返 回 一 个 之 后 可 用 于 检查 响应 数据 的 HttpWebResponse, 


9.24 参考 


MSDN x 档 中 的 “WebRequest 类 ” “WebResponse 类 " “HttpWebRequest 类 ” 和 
"HttpWebResponse 类 ”主题 ， 以 及 统一 资源 标识 符 REC (http://t.cn/R53QItB ) 。 


9.3 通过 代理 服务 器 


9.3.1 问题 


许多 公司 都 有 一 个 代理 服务 器 【有 时 也 称 为 Web RÆ (web proxy)]， 人 允许 雇员 访问 互联 
网 ， 同 时 防止 外 部 人 员 访 问 公司 的 内 部 网 络 。 问 题 在 于 要 创建 一 个 从 公司 内 部 访问 互联 网 
的 一 个 应 用 程序 ， 就 必须 首先 连接 到 代理 服务 器 ， 然 后 通过 它 发 送信 息 ， 而 不 是 直接 连接 
到 一 个 互联 网 Web 服务 器 。 


9.3.2 ”解决 方案 


要 通过 某 个 特定 的 代理 服务 器 成 功 获取 一 个 HttpWebRequest， 你 需要 使 用 一 些 设置 来 设置 
一 个 WebProxy 对 象 ， 这 些 设 置 用 于 验证 对 某 个 给 定 代理 的 特定 请 求 。 因 为 这 一 功能 对 于 所 
有 请 求 都 是 通用 的 ， 所 以 你 可 以 创建 AddProxyInfoToRequest 方法 。 





Console.WriteLine("Request succeeded"); 
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public static HttpWebRequest AddProxyInfoToRequest(HttpWebRequest httpRequest, 


Uri proxyUri, 

string proxyId, 
string proxyPassword, 
string proxyDomain) 


if (httpRequest -- null) 


throw new ArgumentNullException(nameof(httpRequest)); 


// 创建 代理 对 象 
WebProxy proxyInfo = new WebProxy(); 
// 添加 要 使 用 的 代码 服务 的 地 址 
proxyInfo.Address = proxyUri; 
// 将 其 设置 为 针对 本 地 地 址 跳 过 代理 服务 器 
proxyInfo.BypassProxyOnLocal = true; 
// 添加 提供 给 代理 服务 器 的 任意 凭据 信息 
proxyInfo.Credentials = new NetworkCredential(proxyId, 
proxyPassword, 
proxyDomain) ; 
// 将 代理 信息 赋予 请 求 对 象 
httpRequest.Proxy = proxyInfo; 




































































// 返回 请 求 
return httpRequest; 





} 


如 果 所 有 请 求 都 要 通过 相同 的 代理 服务 器 ， 在 Framework 的 1x 版 本 中 ， 使 用 





GlobalProxySelection 类 上 的 静态 Select 方法 为 WebRequest 建立 





代理 服务 器 设置 。 在 1.x 


版 本 之 后 ， 应 当 使 用 WebRequest.DefaultWebProxy 属性 ， 代 码 如 下 所 示 。 


// 将 所 有 请 求 都 设置 为 通过 此 Uri 指 示 的 代理 
Uri proxyURI = new Uri("http://webproxy:80"); 





// 在 1.1 中 ,你 需要 这 样 做 : 
//GlobalProxySelection.Select = new WebProxy(proxyURI); 





// 现在 ,在 2.0 以 及 更 高 版 本 中 ,你 需要 这 样 做 : 
WebRequest.DefaultWebProxy = new WebProxy(proxyURI); 





9.3.3 itit 


AddProxyInfoToRequest 获得 代理 服务 器 的 URI 并 创建 一 个 Uri 对 象 ， 它 用 于 构建 WebProxy 
对 象 。webProxy 对 象 被 设置 为 对 本 地 地 址 绕 过 代理 服务 器 ， 然 后 使 用 凭据 信息 创建 一 个 




















NetworkCredential XF% , NetworkCredential 对 象 代表 随后 在 代 开 








服务 器 完成 请 求 所 必需 


的 验证 信息 ， 并 且 被 赋 给 了 WebProxy.Credentials 属性 。 一 旦 WebProxy 对 象 完成 ， 它 便 被 





赋予 HttpWebRequest 的 Proxy 属性 ， 此 时 请 求 就 准备 好 被 提交 了 。 
要 从 Internet Explorer 中 获得 针对 当前 用 户 的 代理 服务 器 设置 











， 可 以 使 用 System.Net. 


WebRequest.GetSystemWebProxy 方法 ， 然 后 将 返回 的 IWebProxy 赋予 HttpWebRequest 上 的 
代理 服务 器 或 者 WebRequest 上 的 DefaultWebProxy 属性 ， 代 码 如 下 所 示 。 


WebRequest.DefaultWebProxy = WebRequest.GetSystemWebProxy(); 
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9.34 参考 


MSDN 文档 中 的 “WebProxy 2E" “NetworkCredential 类 ”和 “HttpWebRequest 类 ”主题 。 


9.4 从 一 个 URL 获 取 HTML 





9.4.1 问题 


你 需要 获得 从 Web 服务 器 返回 的 HTML 以 便 对 感 兴趣 的 项 进行 检查 。 例 如 ， 你 可 以 从 返 
回 的 HTML 中 检查 到 其 他 页 面 的 链接 或 者 新 闻 站 点 中 的 标题 。 


9.4.2 解决 方案 

你 可 以 使 用 范例 9.1 (BI 9.1 15) 和 范例 9.2 ( 即 9.2 节 ) 中 建立 的 用 于 Web 通信 的 方法 构 
造 HTTP 请 求 并 验证 响应 ， 然 后 就 可 以 通过 HttpWebResponse 对 象 的 ResponseStream 属性 
获得 HTML， 代 码 如 下 所 示 。 


public static async Task<string> GetHtmlFromUrlAsync(Uri url) 


{ 

















string html = string.Empty; 
HttpWebRequest request = GenerateHttpWebRequest(url); 
using(HttpWebResponse response = 
(HttpWebResponse) await request.GetResponseAsync()) 
{ 
if (CategorizeResponse(response) == ResponseCategories. Success) 
{ 
// 获得 响应 流 
Stream responseStream = response.GetResponseStream(); 
// 使 用 一 个 理解 UTF8 的 流 读 取 器 
using(StreamReader reader = 
new StreamReader(responseStream, Encoding.UTF8) ) 


{ 
j 


html = reader.ReadToEnd(); 


} 


return html; 


9.43 讨论 
GetHtmlFromUrlAsync 方法 使 用 GenerateHttpWebRequest 和 GetResponse 方法 获得 一 个 网 


使 用 CategorizeResponse 方法 验证 响应 。 之 后 ， 一 旦 有 了 一 个 有 效 的 响应 ， 就 开始 查 # 
回 的 HTML, 








页 ， 
GR 





HttpWebResponse 上 的 GetResponseStream Fy 7X f f T x Æ System.IO.Stream xf # rp 
返回 的 消息 体 的 访问 。 要 读 取 数据 ， 可 使 用 响应 流 和 Encoding 类 的 UTF8 属性 来 实例 
化 一 个 StreamReader， 从 而 允许 从 流 中 正确 地 读 取 UTES 编码 的 文本 数据 。 然 后 调用 
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StreamReader 的 ReadToEnd 方法 ， 将 所 有 内 容 放 入 命名 为 html 的 字符 串 中 ， 并 且 返 
944 ”参考 


MSDN 文档 中 的 “HttpWebResponse.GetResponseStreanm 方法 
类 ”主题 


9.5 使 用 Web 浏 览 器 控件 


9.5.1 问题 
你 需要 在 基于 WinForms 的 应 用 程序 中 显示 基于 HTML 的 内 容 。 


9.5.2 ”解决 方案 


使 用 System.Windows.Forms.WebBrowser 类 将 Web 浏览 器 功能 企 入 到 应 用 程序 中 。 
示 的 Cheapo-Browser 展示 了 这 一 控件 的 某 些 功能 。 


» & 





回 它 。 





Stream 2E" FH “StringBuilder 
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B 9-1; Web 浏览 器 控件 





虽然 这 不 是 一 个 达到 发 布 产品 质量 的 用 户 界面 〈 所 以 被 称 为 Cheapo-Browser) ， 但 它 可 
用 于 选择 一 个 Web 地 址 ， 显 示 内 容 ， 向 前 和 向 后 导航 ， 取 消 请 求 ， 返 回 主页 ， 直 接 向 控 
件 添 加 HTML， 打 印 或 保存 HTML， 以 及 启用 或 者 取消 浏览 器 窗口 内 部 的 上 下 文 业 单 。 
WebBrowser 控件 的 能 力 不 止 于 此 ， 但 本 范例 的 意图 在 于 让 用 户 尝 试 一 下 可 以 做 到 什么 。 进 
一 步 探索 其 能 力 来 获知 它 可 能 满足 的 其 他 需求 是 很 值得 的 。 

当 你 添加 自己 的 HTML («hi»Hey you added some HTML!</hi>) 时 ， 它 的 显示 如 图 9-2 
所 示 。 
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[V] Enable context menu in browser 
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Hey you added some HTML! 














B 9-2: 向 Cheapo-Browser 添加 HTML 
完成 这 一 任务 的 代码 如 下 所 示 ， 它 相当 简单 。 

this. webBrowser.Document.Body.InnerHtml = "<h1>Hey you added some HTML!</h1>"; 
导航 至 一 个 Web 页 面 的 代码 如 下 所 示 ， 它 与 上 面 的 代码 一 样 简 单 。 


Uri uri = new Uri(this._txtAddress.Text); 
this. webBrowser.Navigate(uri); 


关于 导航 处 理 方式 的 一 个 美妙 之 处 在 于 可 以 订阅 Navigated 事件 ， 以 便 在 导航 完成 时 得 到 











网 络 和 Web | 345 











通知 。 这 允许 代码 在 线程 中 进行 导航 并 在 它 被 完全 加 载 后 继续 处 理 。 该 事件 提供 了 一 个 
WebBrowserNavigatedEventArgs 类 ， 它 拥有 一 个 Uri 属性， 告知 被 导航 至 文档 的 URL， 代 
码 如 下 所 示 。 
private void webBrowser_Navigated(object sender, WebBrowserNavigatedEventArgs e) 
{ 
// 更 新 最 终 到 达 的 url, 以 处 理 从 原始 Uri 重 定向 的 情况 
this._txtAddress.Text = e.Url.ToString(); 
this. btnBack.Enabled = this. webBrowser.CanGoBack; 
this. btnForward.Enabled - this. webBrowser.CanGoForward; 


} 


9.5.3 讨论 

在 .NET Framework 的 1.x 版 本 中 ， 在 WinForms v ARERR RAR Web 浏览 器 更 加 困 
难 并 且 容 易 出 错 。 现 在 有 了 一 种 基于 .NET 的 Web 浏览 器 控件 来 处 理 这 些 难题 。 当 你 试 区 
与 训 览 器 事件 挂 接 时 ， 不 再 需要 费力 处 理 可 能 出 现 的 COM interop 问题 了 。 这 是 一 个 好 机 
会 ， 可 以 使 桌面 应 用 程序 与 Web 应 用 程序 的 界限 更 加 模糊 ， 灵 话 地 结合 使 用 Web 和 富 客 
户 端的 功能 。 

954 ”参考 


MSDN 文档 中 的 “WebBrowser 类 ”主题 。 


9.6 ”以 编程 方式 预 构建 一 个 ASP.NET 网 站 


9.6.1 问题 
你 希望 预 构建 自己 的 网 站 ， 以 避免 编译 延迟 和 源 代 码 需 要 存放 在 服务 器 上 的 托管 场景 。 


9.6.2 ”解决 方案 

使 用 ClientBuildManager 将 自己 的 网 站 预 构建 为 一 个 程序 集 。 要 预 构建 网 站 ， 必 须 指定 以 
下 各 项 。 

。 用 于 Web 应 用 程序 的 虚拟 目录 

。 指向 Web 应 用 程序 目录 的 物理 路 径 

。 你 希望 构建 Web 应 用 程序 的 位 置 

。 帮助 控制 编译 的 标志 

要 预 构建 本 示例 代码 中 的 Web 应 用 程序 ， 首 先 要 获得 Web 应 用 程序 所 在 的 目录 ， 然 后 提 
供 一 个 虚拟 目录 名 和 用 于 构建 Web 应 用 程序 的 位 置 ， 代 码 如 下 所 示 。 


string cscbWebPath = GetWebAppPath(); 

























































































if(cscbWebPath.Length > 0) 
{ 
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string appVirtualDir = @"CSCBWeb"; 
string appPhysicalSourceDir = cscbWebPath; 











LL 


// 将 目标 设置 为 邻近 目录 ,因为 其 不 能 与 源码 在 同一 个 目录 树 中 ， 
// 否则 构建 管理 器 将 报错 
string appPhysicalTargetDir = 
Path.GetDirectoryName(cscbWebPath) + @"\ BuildCSCB"; 
接 下 来 使 用 PrecompilationFlags 枚 举 设 置 用 于 编译 的 标志 。PrecompilationFlags 如 表 9-2 
所 列 。 


表 9-2: PrecompiLationFLags 枚 举 值 






















































































标志 值 目 的 

AllowPartiallyTrustedCallers 向 构建 的 程序 集 添加 APTC 特性 

Clean 移 除 所 有 现存 的 编译 过 的 镜像 

CodeAnalysis 构建 为 代码 分 析 

Default 使 用 默认 编译 选项 

DelaySign 延迟 签署 程序 集 

FixedNames 生成 的 程序 集 带 有 用 于 页 的 固定 名 称 。 不 执行 批 处 理 编译 ， 只 单个 进行 
编译 

ForceDebug 确保 为 调试 进行 程序 集 编译 

OverwriteTarget 如 目标 程序 集 存在 ， 则 履 盖 原 程 序 集 

Updateable 确保 程序 集 是 可 更 新 的 





要 构建 一 个 调试 映像 并 确保 在 编译 没 问题 时 被 成 功 创建 ， 可 使 用 ForceDebug 和 
OverwriteTarget 标志 ， 代 码 如 下 所 示 。 


PrecompilationFlags flags = PrecompilationFlags.ForceDebug | 
PrecompilationFlags.OverwriteTarget; 





然后 ， 将 PrecompilationFlags {F fif 在 ClientBuildManagerParameter 类 的 一 个 新 实 
例 中 ， 并 使 用 已 经 为 之 设置 的 参数 创建 CLientButLdManager。 为 完成 预 构建 ， 要 调用 
PrecompileApplication 方法 。 要 注意 ， 有 一 个 名 为 MyClientBuildManagerCallback 类 的 实 
例 ， 它 被 传递 给 PrecompileApplication 方法 ， 代 码 如 下 所 示 。 


ClientBuildManagerParameter cbmp = new ClientBuildManagerParameter(); 
cbmp.PrecompilationFlags = flags; 





ClientBuildManager cbm = 
new ClientBuildManager(appVirtualDir, 

appPhysicalSourceDir, 
appPhysicalTargetDir, 
cbmp); 

MyClientBuildManagerCallback myCallback - new MyClientBuildManagerCallback(); 

cbm.PrecompileApplication(myCallback) ; 

} 


MyClientBuildManagerCallback 类 从 ClientBuildManagerCallback 类 派生 而 来 ， 人 允许 
代码 在 Web 应 用 程序 编译 期 间接 收 通知 。ClientBuildManagerCallback 类 的 方法 带 有 
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LinkDemands， 要 求 回调 方法 也 带 有 它们 。 编 译 器 错误 、 解 析 错 误 和 进度 通知 都 是 可 用 的 。 
在 MyClientBuildManagerCallback 类 中 ， 它 们 皆 被 实现 为 写 人 到 调试 流 和 控制 台 ， 代 码 如 
下 所 示 。 


public class MyClientBuildManagerCallback : ClientBuildManagerCallback 
{ 











public MyClientBuildManagerCallback() 
: base() 

{ 

} 


[PermissionSet(SecurityAction.Demand, Unrestricted = true)] 
public override void ReportCompilerError(CompilerError error) 


{ 
string msg = $"Report Compiler Error: f{error.ToString()}"; 
Debug.WriteLine(msg); 
Console.WriteLine(msg); 

} 


[PermissionSet(SecurityAction.Demand, Unrestricted = true)] 
public override void ReportParseError(ParserError error) 


{ 
string msg = $"Report Parse Error: f{error.ToString()}"; 
Debug.WriteLine(msg); 
Console.WriteLine(msg); 

} 


[PermissionSet(SecurityAction.Demand, Unrestricted = true)] 
public override void ReportProgress(string message) 


{ 
string msg = $"Report Progress: {message}"; 
Debug.WriteLine(msg); 
Console.WriteLine(msg); 

} 


} 
3B CSCB 网 站 的 成 功 编译 输出 如 下 所 示 。 


Report Progress: Building directory '/CSCBWeb/Properties'. 
Report Progress: Building directory '/CSCBWeb'. 








9.6.3 讨论 
ClientBuildManager 实际 上 是 BuildManager 类 的 瘦 包 装 器 ，BuildManager 类 完成 编译 的 大 
部 分 工作 。ClientBuildManager 能 够 更 直接 地 确保 Web 应 用 程序 的 所 有 重要 部 分 都 得 到 处 
HH, ifj BuildManager 提供 了 更 细 粒 度 的 控制 。ClientBuildManager 还 允许 订阅 诸如 启动 、 
关闭 、 务 载 等 应 用 程序 域 通 知事 件 ， 人 允许 在 预 构建 期 间 应 用 程序 域 销 失 的 事件 中 进行 错误 
处 理 。 
要 在 ASP.NET 中 不 借助 ClientBuildManager 而 预 构建 应 用 程序 ， 可 将 一 个 HTTP 请 求 按 
http://server/webapp/precompile.xsd 格式 发布 到 网 站 上 。precompile.axd“ 文 档 ” 触 发 一 个 将 
为 用 户 预 构建 网 站 的 ASP.NET HttpHandler。 这 一 过 程 通过 aspnet_compiler.exe 模块 处 理 ， 
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该 模块 本 质 上 包含 了 ClientBuildManager 的 功能 。 


96.4 84 


MSDN Xx #4 P ÁJ “ClientBuildManager” “ClientBuildManagerParameters” “BuildManager” 





fl “ASP.NET Web Site Precompilation ”主题 。 


9.7 为 Web 应 用 对 数据 进行 转 义 和 取消 转 义 


9.7.1 问题 


你 需要 将 用 于 Web 操作 的 数据 从 转 义 格式 转换 为 取消 转 义 格式 ， 或 者 执行 相反 的 过 程 以 用 
于 正确 的 传输 。 这 种 转 义 和 取消 转 义 应 当 遵 循 RFC 2396-Uniform Resource Identifiers (URD: 





Generic Syntax 中 描述 的 格式 。 


9.7.2 ”解决 方案 
使 用 Uri 类 上 用 于 转 义 和 取消 转 义 数据 与 Uri 的 静态 方法 。 
要 转 义 数据 ， 可 使 用 静态 Uri.EscapeDataString 方法 ， 如 下 所 示 。 


string data = "<H1>My html</H1>"; 
Console.WriteLine($"Original Data: {data}"); 
Console.WriteLine(); 


string escapedData - Uri.EscapeDataString(data); 
Console.WriteLine($"Escaped Data: {escapedData}"); 
Console.WriteLine(); 


// 上 述 代码 的 输出 为 
// Original Data: <H1>My htmL</H1> 


// 
// Escaped Data: %3CH1%3EMy%20htmL%3C%2FH1%3E 


要 取消 转 义 数据 ， 可 使 用 静态 Uri.UnescapeDataString 方法 ， 代 码 如 下 所 示 。 


string unescapedData = Uri.UnescapeDataString(escapedData) ; 
Console.WriteLine($"Unescaped Data: {unescapedData}"); 
Console.WriteLine(); 








// 上 述 代码 的 输出 为 
// 
// Unescaped Data: <H1>My html</H1> 


要 转 义 一 个 Uri， 可 使 用 静态 Uri.EscapeUristring 方法 ， 代 码 如 下 所 示 。 


string uriString = "http://user:password@localhost:8080/www.abc.com/" + 

"home page. htm?item=1233;html=<hi>Heading</hi>#stuf Ff"; 
Console.WriteLine($"Original Uri string: {uriString}"); 
Console.WriteLine(); 
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string escapedUriString = Uri.EscapeUriString(uriString); 
Console.WriteLine($"Escaped Uri string: {escapedUriString}"); 
Console.WriteLine(); 





// 上 述 代码 的 输出 为 

// 

// Original Uri string: http://user:passwordQlocalhost:8080/www.abc.com/home 
// page. htm?item=1233;html=<h1>Heading</hi>#stuff 

// 

// Escaped Uri string: http://user:password@LlocaLhost:8080/www.abc.com/home 
// %20page.htm?item=1233 ; html=%3Ch1%3EHeading%3C/h1%3E#s tuff 





如 果 你 想 知道 转 义 一 个 Uri 为 何 拥有 其 自己 的 方法 (EscapeUristring)， 可 以 在 其 上 使 用 
Uri.EscapeDataString 和 Uri.UnescapeDataString， 看 一 下 被 转 义 的 Uri 是 什么 样 ， 代 码 如 


下 所 示 。 
// 为 什么 不 直接 使 用 EscapeDataString 来 转 义 一 个 Uri? ” 它 不 够 挑剔 …… 


string escapedUriData = Uri.EscapeDataString(uriString) ; 
Console.WriteLine($"Escaped Uri data: (escapedUriData]"); 
Console.WriteLine(); 





Console.WriteLine(Uri.UnescapeDataString(escapedUriString) ); 





// 上 述 代码 的 输出 为 

// 

// Escaped Uri data: http%3A%2F%2Fuser%3Apassword%40LocaLhost%3A8080%2Fwww. abc. 
// com%2Fhome%20page . htm%3Fitem%3D1233%3BhtmlL%3D%3Ch1%3 EHeading%3C%2Fh1%3E%23 
// stuff 


// http://user:password@localhost:8080/www.abc.com/home page. htm?item=1233;htmL 
// =<h1>Heading</h1>#stuff 


我 们 注意 到 ，:、/、:、@ 和 ? 字符 在 不 应 当 转 义 的 时 候 被 转 义 ， 这 就 是 为 什么 针对 Uri 要 





使 用 EscapeUriString 方法 的 原因 。 





9.7.3 讨论 





EscapeUriString 假设 在 要 被 转 义 的 字符 串 中 不 存在 转 义 序列 。 转 义 遵循 RFC 2396 中 所 制 














定 的 约定 ， 将 所 有 保留 字符 和 值 大 于 128 的 字符 转换 为 其 十 六 进 制 格式 。 
RFC 2396 的 2.2 节 中 声明 的 保留 字符 包括 以 下 这 些 。 














Hl? I:l@1l8&81=1+|1$1, 
在 创建 一 个 System.Uri 对 象 时 ，Escapeurtstring 方法 对 于 确保 Uri 被 正确 转 义 是 非常 有 
用 的 。 
9.7.4 参考 


MSDN 文档 中 的 “EscapeUristring 方法 ”“EscapeUriData 方法 ”和 “UnescapeDataString 


方法 ”主题 。 





9.8 检查 Web 服 务 器 的 自 定 义 错误 页 


9.8.1 问题 


你 有 一 个 应 用 程序 ， 它 需要 知道 给 定 的 IIS 服务 器 上 设置 了 哪些 针对 各 种 HTTP 错误 返回 
码 的 自 定义 错误 页 。 


9.8.2 解决 方案 


使 用 System.DirectoryServices.DirectoryEntry 类 与 Internet Information Server (IIS) 元 
数据 库 交 互 ， 以 找 出 建立 了 哪些 自 定义 错误 页 。 元 数据 库 为 Web 服务 器 保存 配置 信息 。 通 
过 针对 DirectoryEntry 的 构造 函数 指定 “IIS” 模 式 ，DirectoryEntry 使 用 Active Directory 
IIS 服务 提供 程序 与 元 数据 库 进 行 通信 ， 代 码 如 下 所 示 。 
// 这 个 元 数据 库 中 的 一 个 区 分 大 小 写 的 条 目 
// 你 也 许 以 为 它 拼 错 了 ,但 是 你 错 了 …… 


const string WebServerSchema = "IIsWebServer"; 


























// 设置 为 与 本 地 IIS 服 务 器 通信 


string server = "localhost"; 

















// 使 用 假 的 用 户 名 和 密码 创建 一 个 IIS 服 务 器 目录 条 目 
// 如 果 你 以 一 个 常规 用 户 运 行 , 则 需要 提供 凭据 
using (DirectoryEntry w3svc = 
new DirectoryEntry($"IIS://{server}/w3svc", 
"Domain/UserCode", "Password")) 























( 


一 旦 连接 建立 ， 那 么 Web 服 务 器 模式 项 被 指定 于 显示 IIS 设 置 被 保存 的 位 置 
(IIsWebServer), DirectoryEntry 有 一 个 属性 ， 人 允许 对 其 子 项 (Children) 进行 访问 ， 并 
且 针 对 每 个 项 的 SchemaClassName 都 会 被 检查 ， 以 确定 它 是 否 属 于 Web 服务 器 设置 部 分 。 
一 旦 找到 Web 服务 器 设置 ， 那 么 Web 根 节点 即 可 被 定位 ，HttpErrors 属性 可 经 由 此 处 获 
取 。HttpErrors 是 一 个 以 逗号 分 隔 的 字符 串 ， 表 示 HTTP 错误 码 、HTTP 子 错误 码 、 消 息 
类 型 以 及 指向 当 错 误 发 生 时 返回 请 求 端的 HTTP 文件 的 路 径 。 为 完成 这 些 ， 只 需 编写 一 个 
LINQ 查询 获得 所 有 的 HttpErrors， 如 例 9-2 所 示 。 只 要 HttpErrors 被 获取 ， 就 可 以 使 用 
Split 方法 将 它 分 为 一 个 字符 串 数组 ， 人 允许 代码 访问 每 一 个 值 并 将 值 写 出 。 执 行 这 些 操作 
的 代码 如 例 9-2 所 示 。 


例 9-2: 查找 自 定 义 错 误 页 
// 使 用 常规 查询 表达 式 以 
// 选择 机 器 上 所 有 站 点 的 http 错 误 


var httpErrors = from site in w3svc?.Children.OfType<DirectoryEntry>() 












































where site.SchemaClassName == WebServerSchema 
from siteDir in site.Children.OfType<DirectoryEntry>() 
where siteDir.Name -- "ROOT" 


from httpError in siteDir.Properties["HttpErrors"].OfType«string»() 
select httpError; 
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// 使 用 急切 求 值 将 结果 转换 为 数组 

// 以 便于 在 每 个 馆 代 中 不 需要 重新 查询 

// 我 们 将 会 错过 执行 中 元 数据 的 更 新 

// 但 这 相对 于 重新 查询 的 成 本 只 是 很 小 的 代价 
// 这 将 强制 查询 立即 进行 一 次 求 值 

string[] errors = httpErrors.ToArray(); 
foreach (var httpError in errors) 


{ 




















//400,*,FILE,C:\WINDOWS\help\iisHelp\common\400.htm 
string[] errorParts = httpError.ToString().Split(','); 
Console.WriteLine("Error Mapping Entry:"); 
Console.WriteLine($"\tHTTP error code: {errorParts[0]}"); 
Console.WriteLine($"\tHTTP sub-error code: {errorParts[1]}"); 
Console.WriteLine($"\tMessage Type: {errorParts[2]}"); 
Console.WriteLine($"\tPath to error HTML file: f{errorParts[3]}"); 
} 


无 需 使 用 LINQ 去 查询 元 数据 库 当 然 也 可 以 完成 这 一 工作 ， 如 例 9-3 所 示 。 
例 9-3: 不 使 用 LINQ 查找 自 定 义 错误 页 


foreach (DirectoryEntry site in w3svc?.Children) 


{ 





if (site != null) 
{ 


using (site) 


// 检查 机 器 上 的 所 有 Web 服务 器 


if (site.SchemaClassName == WebServerSchema) 


( 





// 获得 此 服务 器 的 元 数据 库 条 目 


string metabaseDir = $"/w3svc/{site.Name}/ROOT"; 





if (site.Children != null) 





// 查找 每 一 服务 器 的 ROOT 目 录 
foreach (DirectoryEntry root in site.Children) 
{ 
using (root) 
{ 
// 我 们 是 否 找到 了 此 站 点 的 根 目 录 
if (root?.Name.Equals("ROOT", 
StringComparison.OrdinallgnoreCase) ?? false) 





{ 
// 获得 HttpErrors 
if (root?.Properties.Contains("HttpErrors") == true) 


{ 





// 输出 
PropertyValueCollection httpErrors = 
root?.Properties["HttpErrors"]; 
for (int i = 0; i < httpErrors?.Count; i++) 
{ 
//400,*, FILE, 
//C:\WINDOWS\help\iisHelp\common\400.htm 
string[] errorParts = 
httpErrors?[i].ToString().Split(','); 





Console.WriteLine("Error Mapping Entry:"); 
Console.WriteLine($"\tHTTP error code:" + 
$"{errorParts[0]}"); 
Console.WriteLine($"\tHTTP sub-error code:" + 
$"{errorParts[1]}"); 
Console.WriteLine($"\tMessage Type: 
$"{errorParts[2]}"); 
Console.WriteLine( 
$"\tPath to error HTML file: 
ferrorParts[3]]"); 


+ 


} 


至 此 ， 应 用 程序 可 以 缓存 这 些 映射 自己 错误 结果 的 设置 ， 或 者 可 以 动态 地 修改 错误 页 ， 
提供 自 定义 的 内 容 。 此 处 的 结构 是 ， 用 于 Web 服务 器 
可 用 的 ， 只 需要 一 小 点 代码 。 


9.8.3 讨论 
System.DirectoryServices.DirectoryEntry 通常 用 于 Active Directory 编程 ， 但 它 也 能 够 使 


用 任何 可 用 于 Active Directory 的 提供 程序 。 这 一 方法 允许 代码 检查 IS 元 数据 库 ， 不 管 
较 老 的 TIS 5.x 元 数据 库 还 是 Windows Server 自 带 的 较 新 IIS 元 数据 库 。 


在 例 9-2 中 ,LINQ 被 用 于 查询 元 数据 库 ， 一 些 有 趣 的 事情 发 生 了 。 查 询 壳 历 了 元 
数据 层次 以 获取 HttpErrors， 但 应 当 注 意 到 ，DirectoryEntry.ChiLdren 属性 是 一 
个 DirectoryEntries 集 合 类 。DirectoryEntries 确实 支持 IEnumerable， 但 它 不 支持 
IEnumerabLe<T>， 而 后 者 是 LINQ 工 作 所 需 的 。0fType<DirectoryEntry> 扩展 方法 从 
DirectoryEntries 支持 的 IEnumerable 接口 中 返回 强 类 型 的 IEnumerabLe<DirectoryEntry>。 
这 样 做 可 以 找 出 网 站 和 根 目录 ， 然 后 可 以 使 用 0fType<string> 获得 一 个 带 有 HttpErrors 的 
字符 串 的 枚 举 列表 。 


var httpErrors = from site in w3svc?.Children.OfType<DirectoryEntry>() 
























































where site.SchemaClassName == WebServerSchema 
from siteDir in site.Children.OfType<DirectoryEntry>() 
where siteDir.Name == "ROOT" 


from httpError in 
siteDir.Properties["HttpErrors"].0fType<string>() 
select httpError; 


我 们 使 用 了 常规 的 查询 表达 式 语法 编写 查询 ， 但 我 们 也 可 以 使 用 被 称 为 显 式 点 标记 
(explicit dot notation) 的 语法 来 建立 查询 ， 如 下 所 示 。 
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var httpErrors = w3svc?.Children.OfType<DirectoryEntry>() 
.Where(site => site.SchemaClassName == WebServerSchema) 
.SelectMany(siteDir => 
siteDir.Children.OfType«DirectoryEntry»()) 
.Where(siteDir -» siteDir.Name -- "ROOT") 
.SelectMany«DirectoryEntry, string>(siteDir => 
siteDir.Properties["HttpErrors"].OfType«string»()); 


式 点 标记 语法 只 是 直接 从 集合 类 型 或 已 扩展 的 接口 上 调用 扩展 方法 ，LINQ 正 是 建立 在 
些 扩 展 方法 之 上 。 这 些 扩展 方法 在 System. Core 程序 集中 的 System. Ling 命名 空间 下 的 
态 Enumerable 类 上 定义 ， 是 查询 表达 式 语 法 构建 的 基础 。 查 询 表达 式 语法 告诉 CH 编译 
器 使 用 这 些 扩展 方法 来 执行 所 请 求 的 查询 。 

通过 使 用 多 个 from 语句 ， 可 以 将 SelectMany 的 使 用 隐 仿 在 通常 的 查询 语法 中 。SelectMany 
允许 查询 将 结果 折 县 到 一 个 单独 的 集合 中 ， 从 而 得 到 IEnumerable<string> 作为 httpErrors 
结果 。 如 果 使 用 Select， 那 么 结果 可 能 会 是 IEnumerabLe<IEnumerabLe<string>>; 它 是 一 
个 字符 串 集合 的 集合 ， 而 不 是 一 个 连续 的 集合 。 

要 构建 第 一 处 的 查询 ， 更 容易 的 方法 是 从 单独 的 较 小 查询 入 手 ， 然 后 组 合 它们 。 当 使 用 显 
式 点 标记 语法 时 ， 使 用 下 列子 查询 可 以 容易 地 重新 进行 组 合 。 


// 使 用 显 式 点 标记 语法 拆散 查询 ,首先 获得 站 点 ， 
// 然后 获得 http 错 误 属 性 值 











显 
这 
静 
ay 


















































var sites = w3svc?.Children.OfType«DirectoryEntry»() 
.Where(child => child.SchemaClassName == WebServerSchema) 
.SelectMany(child => child.Children.OfType<DirectoryEntry>()); 


var httpErrors = sites 
.Where(site => site.Name == "ROOT") 
.SelectMany<DirectoryEntry,string>(site => 
site.Properties["HttpErrors"].O0fType<string>()); 


// 使 用 显 式 点 标记 语法 组 合 查 询 

var combinedHttpErrors = w3svc?.Children.OfType«DirectoryEntry»() 
.Where(site => site.SchemaClassName == WebServerSchema) 
.SelectMany(siteDir => 

siteDir.Children.OfType<DirectoryEntry>()) 
.Where(siteDir => siteDir.Name == "ROOT") 
.SelectMany<DirectoryEntry, string>(siteDir => 
siteDir.Properties["HttpErrors"].OfType«string»()); 


98.4 参考 


MSDN 文档 中 的 “SelectMany<TSource，TResult> 方法 ”“0fType<TResult> 方法 ”“HttpErrors 
[IIS]" “IIS Metabase Properties” 和 “DirectoryEntry 类 ”主题 。 





9.9 编写 一 个 TCP 服 务 器 


9.9.1 问题 

你 需要 创建 一 个 服务 器 ， 以 安全 或 非 安 全 的 方式 在 一 个 端口 上 侦 听 来 自 TCP 客户 端的 进入 
请 求 。 然 后 在 服务 器 端 处 理 这 些 客户 端 请 求 ， 并 将 任何 响应 发 送 回 客户 端 。 范 例 9.10 (Hl 
9.10 节 ) 展示 了 如 何 编写 一 个 与 该 服务 器 交互 的 TCP 客户 端 。 


9.9.2 ”解决 方案 
使 用 这 里 创建 的 MyTcpServer 类 ， 在 基于 TCP 的 端点 侦 听 到 达 给 定 端口 的 请 求 ， 代 码 如 下 
所 示 。 


class MyTcpServer 


{ 


























#region Private Members 

private TcpListener _listener; 

private IPAddress _address; 

private int _port; 

private bool _listening; 

private string _sslServerName; 

private object _syncRoot = new object(); 
#endregion 


#region CTORs 


public MyTcpServer(IPAddress address, int port, string sslServerName = null) 


{ 
_port = port; 
_address = address; 
_sslServerName = sslServerName; 
} 


#endregion // CTORs 


MyTcpServer 类 有 以 下 四 个 属性 。 
。 Address， 一 个 IPAddress 

e Port, 一 个 int 

。 Listening, 一 个 bool 


。 SSLServerName, 一 个 string 


这 些 属 性 返回 服务 器 正在 侦 听 的 当前 地 址 和 端口 ， 侦 听 状 态 ， 以 及 MyTcpServer 侦 听 的 
SSL (secure sockets layer) 服务 器 名 称 。 





#region Properties 
public IPAddress Address { get; } 


public int Port { get; } 


public bool Listening { get; private set; } 
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public string SSLServerName { get; } 
#endregion 


ListenAsync 方法 告诉 MyTcpServer 类 开始 侦 听 指定 的 地 址 和 端口 组 合 。 生 成 并 局 动 一 个 
TcpListener， 然 后 运行 一 个 Task 调用 它 的 AcceptTcpCLientAsync 方法 以 等 待 将 要 到 达 的 
某 个 客户 端 请 求 。 一 旦 客户 端 连接 上 ， 运 行 ProcessClientAsync 方法 以 服务 客户 端 交 互 。 
服务 完 客 户 端 后 侦 听 器 关闭 。 

#region Public Methods 


public async Task ListenAsync(CancellationToken cancellationToken = 
default(CancellationToken)) 








{ 
cancellationToken.ThrowIfCancellationRequested(); 
try 
{ 
lock (_syncRoot) 
{ 
_listener = new TcpListener(Address, Port); 
// 启动 服务 器 
_listener.Start(); 
// 设置 侦 听 标志 
Listening = true; 
} 
// 进入 侦 听 循环 
do 
{ 
Console.Write("Looking for someone to talk to... "); 
// 等 待 连接 
try 
{ 


cancellationToken.ThrowIfCancellationRequested(); 
await Task.Run(async () => 
{ 
TcpClient newClient = 
await _listener.AcceptTcpClientAsync(); 
Console.WriteLine("Connected to new client"); 
await ProcessClientAsync(newClient, cancellationToken); 
J,cancellationToken); 














} 
catch (OperationCanceledException) 
{ 
// 用 户 取消 
Listening = false; 
} 
while (Listening); 
} 
catch (SocketException se) 
{ 
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Console.WriteLine($"SocketException: {se}"); 


} 
finally 
{ 
// RAVE 
StopListening(); 
} 


} 
调用 StopListening 方法 以 停止 MyTCPServer 侦 听 请 求 ， 代 码 如 下 所 示 。 


public void StopListening() 


















































{ 
if (Listening) 
{ 
lock (_syncRoot) 
{ 
// 设置 侦 听 标志 
Listening = false; 
try 
{ » 
// 如 果 在 侦 听 , 则 关闭 它 
if ( listener.Server.IsBound) 
_listener.Stop(); 
} 
catch (ObjectDisposedException) 
{ 
// 如 果 我 们 尝试 在 AcceptTcpClientAsync 中 
// 等 待 一 个 连接 时 (因为 它 是 阻塞 操作 ) 停 止 侦 听 ， 
// 它 将 引发 一 个 0bjectDisposedException 异 常 ， 
// 因为 在 此 处 我 们 知道 我 们 正在 关闭 
// 只 需 提 示 我 们 取消 了 侦 听 
Console.WriteLine("Cancelled the listener"); 
} 
} 
} 
} 
#endregion 


例 9-4 所 示 的 ProcessClientAsync 方法 执行 以 服务 于 一 个 连接 的 客户 端 。 它 确定 是 否 已 设 
A SSL 连接 的 服务 器 名 称 ， 如 果 已 设置 ， 使 用 TcpClient.GetStream 创建 一 个 SslStream, 
并 使 用 配置 的 服务 器 名 称 获取 服务 器 证 书 。 然 后 使 用 AuthenticateAsServer 方法 进行 身份 
验证 。 如 果 不 使 用 SSL，ProcessClientAsync 会 使 用 TcpClient.GetStream 方法 从 客户 端 获 
得 Networkstreamn， 然 后 读 取 整 个 请 求 。 发 送 回 一 个 响应 之 后 ， 该 方法 关闭 客户 端 连接 。 
例 9-4: ProcessClientAsyn 方法 

#region Private Methods 


private async Task ProcessClientAsync(TcpClient client, 
CancellationToken cancellationToken = default(CancellationToken)) 











{ 
cancellationToken.ThrowIfCancellationRequested(); 
try 
{ 














a 


// 用 于 读 取 数 据 的 缓 州 





X. 
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byte[] bytes = new byte[1024]; 
StringBuilder clientData = new StringBuilder(); 


Stream stream = null; 
if (!string.IsNullOrWhiteSpace(SSLServerName)) 


{ 
Console.WriteLine($"Talking to client over SSL using {SSLServerName}") ; 
SslStream sslStream = new SslStream(client.GetStream()); 
sslStream.AuthenticateAsServer(GetServerCert(SSLServerName), false, 

SslProtocols.Default, true); 

stream = sslStream; 

} 

else 

{ 


Console.WriteLine("Talking to client over regular HTTP"); 
stream = client.GetStream(); 


} 
// 获得 流 以 与 客户 端 通信 
using (stream) 


( 





// 将 初始 读 取 超时 设置 为 1 分 钟 以 允许 连接 
stream.ReadTimeout = 60000; 

// 循环 以 获取 客户 端 发 送 的 所 有 数据 

int bytesRead = 0; 


















































do 
{ 
// 这 看 起 来 像 是 一 个 bug, 但 它 显然 不 是 …… 
// 当 我 们 使 用 Read 方 法 时 ,第 一 次 工作 正常 ， 
// 然后 第 二 次 读 取 没 有 数据 时 ， 
// 因 NetworkStream 上 设置 的 0.5 秒 超时 而 引发 IOException 
// 如 果 我 们 使 用 ReadAsync ,第 二 次 读 取 没 有 数据 时 将 永远 挂 起 
// 这 是 因为 使 用 Async 时 ,Socket 类 上 的 超时 将 被 忽略 
try 
{ 
// 此 处 使 用 Read 而 不 是 ReadAsync, 因 为 如 果 你 调用 ReadAsync， 
// 将 不 会 如 你 所 预期 的 那样 发 生 超时 (参见 上 面 的 注解 ) 
bytesRead = stream.Read(bytes, 0, bytes.Length); 
if (bytesRead > 0) 
{ 
// 将 数据 字 节 转换 为 ASCII 字 符 串 并 附加 到 clientData 
clientData.Append( 
Encoding.ASCII.GetString(bytes, 0, bytesRead)); 
// 既然 数据 已 经 到 来 ,将 读 取 超时 缩减 为 1/2 秒 
stream.ReadTimeout = 500; 
J 
} 
catch (IOException ioe) 
// 读 取 超时 ,所 有 数据 已 被 获取 
Trace.WriteLine($"Read timed out: {ioe}"); 
bytesRead = 0; 
} 
} 


while (bytesRead > 0); 





Console.WriteLine($"Client says: {clientData}"); 


// 感谢 他 们 的 输入 
bytes = Encoding.ASCII.GetBytes("Thanks call again!"); 


// 发 送 回响 应 


await stream.WriteAsync(bytes, 0, bytes.Length, cancellationToken); 





} 

} 

finally 

t 
// 停止 与 客户 端的 交互 
client?.Close(); 

} 


} 


最 后 ， 将 MyTCPServer 设置 为 使 用 SSL HF, GetServerCert 方法 会 获取 X509Certificate, 
该 方法 要 求 本 地 计算 机 上 个 人 证 书 存储 中 的 证 书 是 可 访问 的 。 如 果 它 是 一 个 自 签 名 证 书 ， 
则 该 证 书 需要 在 受信 任 的 根 证 书 存储 区 中 都 可 用 。 


private static X509Certificate GetServerCert(string subjectName) 


{ 


























using (X509Store store = 
new X509Store(StoreName.My, StoreLocation.LocalMachine) ) 
{ 
store.Open(OpenFlags.ReadOnly); 
X509CertificateCollection certificate - 
store.Certificates.Find(X509FindType.FindBySubjectName, 
subjectName, true); 


if (certificate.Count » 0) 
return (certificate[0]); 
else 
return (null); 


} 


下 面 是 一 个 简单 服务 器 的 示例 ， 该 服务 器 在 按 下 Escape 键 之 前 一 直 侦 听 客 户 端 。 


class Program 


( 

















private static MyTcpServer server; 
private static CancellationTokenSource cts; 


static void Main() 

{ 
_cts = new CancellationTokenSource(); 
try 
{ 











// 我 们 并 不 等 待 这 一 调用 ,因为 我 们 想 要 继续 执行 
// 以 使 得 控制 台 UI 可 以 处 理 按键 


RunServer(_cts.Token); 

















} 


catch(Exception ex) 
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{ 
} 


string msg = "Press Esc to stop the server..."; 
Console.WriteLine(msg); 

ConsoleKeyInfo cki; 

while (true) 


Console.WriteLine(ex.ToString()); 





{ 
cki = Console.ReadKey(); 
if (cki.Key == ConsoleKey. Escape) 
{ 
_cts.Cancel(); 
_server.StopListening(); 
break; // 允许 退出 
} 
} 


Console.WriteLine(""); 
Console.WriteLine("All done listening"); 


} 
private static async Task RunServer(CancellationToken cancellationToken) 
{ 
try 
{ 
await Task.Run(async() => 
{ 
cancellationToken.ThrowIfCancellationRequested(); 
server = new MyTcpServer(IPAddress.Loopback, 55555); 
await server.ListenAsync(cancellationToken); 
}, cancellationToken); 
} 
catch (OperationCanceledException) 
{ 
Console.WriteLine("Cancelled."); 
} 
} 


} 
当 与 范例 9.10 (BN 9.10 节 ) 中 的 MyTcpClient 类 对 话 时 ， 服 务 器 的 输出 如 下 所 示 。 


Press Esc to stop the server... 


Looking for someone to talk to... Connected to new client 
Client says: Just wanted to say hi 

Looking for someone to talk to... Connected to new client 
Client says: Just wanted to say hi again 

Looking for someone to talk to... Connected to new client 
Client says: Are you ignoring me? 

Looking for someone to talk to... Connected to new client 
Client says: I'll not be ignored! (round 0) 

Looking for someone to talk to... Connected to new client 
Client says: I'll not be ignored! (round 1) 

Looking for someone to talk to... Connected to new client 
Client says: I'll not be ignored! (round 2) 

Looking for someone to talk to... Connected to new client 


Client says: I'll not be ignored! (round 3) 
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Looking for someone to talk to... Connected to new client 
Client says: I'll not be ignored! (round 4) 
Looking for someone to talk to... Connected to new client 
Client says: I'll not be ignored! (round 5) 
Looking for someone to talk to... Connected to new client 
Client says: I'll not be ignored! (round 6) 
Looking for someone to talk to... Connected to new client 
Client says: I'll not be ignored! (round 7) 
Looking for someone to talk to... Connected to new client 
Client says: I'll not be ignored! (round 8) 
Looking for someone to talk to... Connected to new client 
Client says: I'll not be ignored! (round 9) 
Looking for someone to talk to... Connected to new client 
Client says: I'll not be ignored! (round 10) 


9.9.3 


[more output follows... ] 


讨论 


传输 控制 协议 (TCP) 是 目前 互联 网 上 大 多 数 通信 所 使 用 的 协议 。TCP 负责 从 一 端 到 另 一 
端正 确 地 传递 数据 包 。 它 使 用 互联 网 协议 (P) 执行 传递 。IP 处 理 节 点 间 的 包 获 取 ，TCP 
检测 包 何 时 不 正确 、 丢 失 或 无 序 发送 ， 并 且 安 排 重 发 丢失 或 者 损坏 的 包 。MyTCPserver 类 
是 一 种 基本 的 服务 器 机 制 ， 用 来 处 理 TCP 上 客户 端的 请 求 。 


MyTcpServer 获得 传递 到 构造 国 数 的 耳 地 址 和 端口 ， 并 且 在 该 IPAddress 和 端口 上 
创建 一 个 TcpListener。 一 旦 创建 完毕 ， 就 调用 TcpListener.Start 方 法 启动 服务 器 。 
AcceptTcpClientAsync 方法 被 调用 以 侦 听 来 自 基 于 TOP 的 客户 端 请 求 并 等 待 来 自 客户 端 
的 连接 。 一 旦 客户 端 连接 上 ， 将 执行 ProcessClientAsyn 方法 。 在 这 个 方法 中 ， 服 务 器 读 
取 来 自 客 户 端 的 请 求 数据 并 返回 一 个 简要 回执 。 服 务 器 端 通过 调用 TcpClient.Close 与 
客户 端 断 开 连接 。 当 调用 StopListening 方法 时 ， 服 务 器 停止 。StopListening 通过 调用 
TcpListener.Stop 使 服务 器 离线 。 





















































要 支持 安全 的 请 求 ， 你 可 以 在 MyTCPServer 构造 函数 中 设置 SSLServerName， 用 于 标识 要 使 
用 的 身份 验证 的 证 书 。 


运行 服务 器 的 程序 然后 在 类 构造 函数 中 提供 此 名 称 ， 如 下 所 示 。 


_server = new MyTcpServer(IPAddress.Loopback, 55555, "CSharpCookBook.net"); 














在 ListenAsync 方法 中 ， 我 们 使 用 了 lock 语句， 代码 如 下 所 示 。 


public async Task ListenAsync(CancellationToken cancellationToken = 


{ 


default(CancellationToken)) 


cancellationToken.ThrowIfCancellationRequested(); 
try 


{ 
lock (_syncRoot) 


{ 


_listener = new TcpListener(Address, Port); 


// 启动 服务 器 
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_listener.Start(); 


// 设置 侦 听 标志 
Listening = true; 


} 


MSDN 中 将 lock 定义 为 如 下 : lock 关键 字 将 语句 块 标记 为 临界 区 ， 方 法 是 
获取 给 定 对 象 的 互 斥 锁 ， 执 行 语句 ， 然 后 释放 该 锁 。 虽 然 这 是 事实 ， 你 可 以 
更 简单 地 认为 :“ 没 有 其 他 线程 将 运行 lock 语句 放 在 方 括号 内 的 代码 部 分 ， 
直到 第 一 个 线程 完成 。 那些 喜欢 挑战 极限 的 人 可 能 会 想 :“ 嘿 ， 我 可 以 在 
lock 语句 内 使 用 async 和 await， 然 后 它 将 让 行 给 下 一 个 线程 ， 对 吗 ? ”是 
的 ， 从 技术 上 讲 可 以 ,但 是 你 不 应 该 这 样 做 ， 因 为 它 儿 乎 肯定 会 在 你 的 应 用 
程序 中 导致 死 锁 。 你 await 的 代码 可 能 执行 了 lock iii BSC Hi. lock 内 部 
的 代码 也 可 能 恢复 到 另 一 个 线程 〈 因 为 当 你 await， 它 通常 不 会 恢复 到 同一 
线程 上 ) ， 所 以 你 会 从 不 同 的 线程 中 解锁 ， 而 不 是 建立 锁 的 那个 线程 。 这 是 
一 个 “非常 坏 的 事情 "， 所 以 请 不 要 这 样 做 。 













































































9.9.4 参考 


MSDN 文档 中 的 “IPAddress 类 " “TcpListener 2E " "SslStream 2& " "lock 语句 ” 和 
“TepClient 类 ”主题 。 


9.10 编写 一 个 TCP 客 户 端 


9.10.1 问题 
你 希望 以 安全 或 非 安全 的 方式 与 一 个 基于 TCP 的 服务 器 交互 。 


9.10.2 ”解决 方案 

使 用 例 9-5 所 示 的 MyTcpClient 类 ， 传 人 要 对 话 的 服务 器 地 址 、 端 口 和 SSL 服务 器 名 (如 
果 已 进行 身份 验证 )， 使 用 System.Net.TcpCLient 类 与 一 个 基于 TCP 的 服务 器 连接 并 对 话 。 
该 示例 将 与 范例 9.9 ( 即 9.9 节 ) 中 的 服务 器 对 话 。 


例 9-5: MyTcpClient 类 
class MyTcpClient : IDisposable 





private TcpClient _client; 
private IPEndPoint _endPoint; 
private bool _disposed; 


#region Properties 
public IPAddress Address { get; } 


public int Port { get; } 
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public string SSLServerName { get; } 


#endregion 


public MyTcpClient(IPAddress address, int port, string sslServerName = 


{ 


Address = address; 

Port = port; 

_endPoint = new IPEndPoint(Address, Port); 
SSLServerName - sslServerName; 


} 


public async Task ConnectToServerAsync(string msg) 


{ 


try 


{ 


_client = new TcpClient(); 


await _client.ConnectAsync(_endPoint.Address, endPoint.Port); 


Stream stream = null; 
if (!string.IsNullOrWhiteSpace(SSLServerName)) 
{ 


SslStream sslStream = 
new SslStream( client.GetStream(), false, 


new RemoteCertificateValidationCallback( 


CertificateValidationCallback)); 
sslStream.AuthenticateAsClient(SSLServerName); 


DisplaySSLInformation(SSLServerName, sslStream, 


stream - sslStream; 


























true); 


null) 


} 
else 
{ 
stream = _client.GetStream(); 
} 
using (stream) 
{ 
// 获得 要 发 送 消 息 的 字 节 数据 
byte[] bytes = Encoding.ASCII.GetBytes(msg); 
// 发 送 消息 
Console.WriteLine($"Sending message to server: {msg}"); 
await stream?.WriteAsync(bytes, 0, bytes.Length); 
// 获得 响应 
// 用 于 保存 响应 字 节 数据 的 缓冲 区 
bytes = new byte[1024]; 
// 显示 响应 
int bytesRead = await stream?.ReadAsync(bytes, 0, bytes.Length); 
string serverResponse = 
Encoding.ASCII.GetString(bytes, 0, bytesRead); 
Console.WriteLine($"Server said: {serverResponse}"); 
} 





网 络 和 Web 


363 


catch (SocketException se) 


{ 
Console.WriteLine($"There was an error talking to the server: {se}"); 
} 
finally 
{ 
Dispose(); 
} 


} 
#region IDisposable Members 


public void Dispose() 


{ 
Dispose(true); 
GC.SuppressFinalize(this); 
} 
private void Dispose(bool disposing) 
{ 
if (!_disposed) 
{ 
if (disposing) 
_client?.Close(); 
} 
_disposed = true; 
} 
} 
#endregion 


private bool CertificateValidationCallback(object sender, 
X509Certificate certificate, 
X509Chain chain, 
SslPolicyErrors sslPolicyErrors) 


{ 

if (sslPolicyErrors == SslPolicyErrors.None) 

{ 
return true; 

} 

else 

{ 
if (sslPolicyErrors == SslPolicyErrors.RemoteCertificateChainErrors) 
{ 


Console.WriteLine("The X509Chain.ChainStatus returned an array of " + 
"X509ChainStatus objects containing error information."); 
} 
else if (sslPolicyErrors == 
SslPolicyErrors.RemoteCertificateNameMismatch) 
{ 
Console.WriteLine( 
"There was a mismatch of the name on a certificate."); 
} 


else if (sslPolicyErrors == 





} 


SslPolicyErrors.RemoteCertificateNotAvailable) 


{ 
Console.WriteLine("No certificate was available."); 
} 
else 
{ 
Console.WriteLine("SSL Certificate Validation Error!"); 
} 


Console.WriteLine(""); 
Console.WriteLine("SSL Certificate Validation Error!"); 
Console.WriteLine(sslPolicyErrors.ToString()); 


return false; 


private static void DisplaySSLInformation(string serverName, 


( 


} 


SslStream sslStream, bool verbose) 
DisplayCertInformation(sslStream.RemoteCertificate, verbose); 


Console.WriteLine(""); 

Console.WriteLine($"SSL Connect Report for : {serverName}"); 
Console.WriteLine(""); 

Console.WriteLine( 


$"Is Authenticated: {sslStream. IsAuthenticated}"); 
Console.WriteLine($"Is Encrypted: (sslStream.IsEncrypted]"); 
Console.WriteLine($"Is Signed: {sslStream.IsSigned}"); 
Console.WriteLine($"Is Mutually Authenticated: "+ 


$"(sslStream.IsMutuallyAuthenticated]"); 
Console.WriteLine(""); 


Console.WriteLine($"Hash Algorithm: (sslStream.HashAlgorithm)"); 
Console.WriteLine($"Hash Strength: {sslStream.HashLength}"); 
Console.WriteLine( 
$"Cipher Algorithm: {sslStream.CipherAlgorithm}") ; 
Console.WriteLine( 
$"Cipher Strength: {sslStream.CipherStrength}") ; 
Console.WriteLine(""); 
Console.WriteLine($"Key Exchange Algorithm: "+ 
$"(sslStream.KeyExchangeAlgorithm]"); 
Console.WriteLine($"Key Exchange Strength: "+ 
$"{sslStream.KeyExchangeStrength}"); 
Console.WriteLine(""); 
Console.WriteLine($"SSL Protocol: [sslStream.SslProtocol]"); 


private static void DisplayCertInformation(X509Certificate remoteCertificate, 


{ 


bool verbose) 


Console.WriteLine(""); 
Console.WriteLine("Certificate Information for:"); 
Console.WriteLine($"{remoteCertificate.Subject}"); 
Console.WriteLine(""); 

Console.WriteLine("Valid From:"); 
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Console.WriteLine($"{remoteCertificate.GetEffectiveDateString()}"); 
Console.WriteLine("Valid To:"); 
Console.WriteLine($"{remoteCertificate.GetExpirationDateString()}"); 
Console.WriteLine("Certificate Format:"); 
Console.WriteLine($"{remoteCertificate.GetFormat()}"); 
Console.WriteLine(""); 

Console.WriteLine("Issuer Name:"); 
Console.WriteLine($"{remoteCertificate.Issuer}"); 


if (verbose) 


( 


Console.WriteLine("Serial Number:"); 
Console.WriteLine($"{remoteCertificate.GetSerialNumberString()}"); 
Console.WriteLine("Hash:"); 
Console.WriteLine($"{remoteCertificate.GetCertHashString()}"); 
Console.WriteLine("Key Algorithm:"); 
Console.WriteLine($"{remoteCertificate.GetKeyAlgorithm()}"); 
Console.WriteLine("Key Algorithm Parameters:"); 

Console.WriteLine( 


$"{remoteCertificate.GetKeyAlgorithmParametersString()}"); 


Console.WriteLine("Public Key:"); 
Console.WriteLine($"{remoteCertificate.GetPublicKeyString()}"); 


j 


要 在 





程序 中 使 用 MyTcpCtient， 你 可 以 简单 地 生成 它 的 一 个 实例 并 调用 


ConnectToServerAsync 发 送 一 个 请 求 。 在 TalkToServerAsync 方法 中 ， 首 先 对 服务 器 端 执行 


三 个 调 月 























月， 以 测试 基本 机 制 ， 并 等 待 MakeClientCallToServer 方法 的 结果 。 接 下 来 ， 进 入 





一 个 循环 在 其 上 真正 运行 并 创建 多 个 Task ilok, 4% EB f MakeClientCallToServerAsync 
这 验证 了 服务 器 端 处 理 多 个 请 求 的 机 制 是 合理 的 。 


static void Main() 


方法 。 


{ 


Task ser 
serverCh 









































verChat = TalkToServerAsync(); 
at.Wait(); 


Console.WriteLine(@"Press the ENTER key to continue..."); 


Console. 


} 


private stat 


{ 


Read(); 


ic async Task MakeClientCallToServerAsync(string msg) 


MyTcpClient client = new MyTcpClient(IPAddress.Loopback, 55555); 
// 取消 注释 以 使 用 SSL 与 服务 器 对 话 





//MyTcpClient client = new MyTcpClient(IPAddress.Loopback, 55555, 
// "CSharpCookBook.net"); 
await client.ConnectToServerAsync(msg) ; 


} 


private static async Task TalkToServerAsync() 


{ 


await Ma 
await Ma 
await Ma 


keClientCallToServerAsync("Just wanted to say hi"); 
keClientCallToServerAsync("Just wanted to say hi again"); 
keClientCallToServerAsync("Are you ignoring me?"); 
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// 现在 发 送 一 批 消 息 
string msg; 
for (int i = 0; i < 100; i++) 








{ 
msg = $"I'll not be ignored! (round {i})"; 
RunClientCallAsTask(msg); 
} 
} 
private static void RunClientCallAsTask(string msg) 
{ 
Task work = Task.Run(async () => 
{ 
await MakeClientCallToServerAsync(msg); 
9; 
} 





用 于 这 些 消息 交换 的 客户 端 输出 如 下 所 示 。 


Sending message to server: Just wanted to say hi 

Server said: Thanks call again! 

Sending message to server: Just wanted to say hi again 
Server said: Thanks call again! 

Sending message to server: Are you ignoring me? 

Server said: Thanks call again! 

Press the ENTER key to continue... 

Sending message to server: I'll not be ignored! (round 1) 
Sending message to server: I'll not be ignored! (round 0) 
Sending message to server: I'll not be ignored! (round 2) 
Sending message to server: I'll not be ignored! (round 3) 
Sending message to server: I'll not be ignored! (round 4) 
Sending message to server: I'll not be ignored! (round 6) 
Sending message to server: I'll not be ignored! (round 5) 
Sending message to server: I'll not be ignored! (round 7) 
Sending message to server: I'll not be ignored! (round 9) 
Sending message to server: I'll not be ignored! (round 10) 


[once all requests are set up as tasks you see the responses... ] 


Server said: Thanks call again! 
Server said: Thanks call again! 
Server said: Thanks call again! 
Server said: Thanks call again! 
Server said: Thanks call again! 
Server said: Thanks call again! 
Server said: Thanks call again! 
Server said: Thanks call again! 
Server said: Thanks call again! 
Server said: Thanks call again! 
Server said: Thanks call again! 


9.10.3 iit 


MyTcpClient.ConnectToServerAsync 设计 用 于 发 送 一 条 消息 ， 获 得 响应 ， 显 示 为 一 个 字符 
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串 ， 然 后 关闭 连接 。 为 了 完成 这 项 工作 ， 它 生成 一 个 System.Net.TcpClient 并 通过 调用 
TcpClient.ConnectAsync 方法 与 服务 器 连接 。ConnectAsync 通过 使 用 传 入 MyTCpClient 构造 
函数 的 地 址 和 端口 构建 一 个 IPEndPoint 来 指定 服务 器 。 
MyTCpClient.ConnectToServerAsync 然后 使 用 Encoding.ASCII.GetBytes 方法 获得 对 应 字符 
串 的 字 节 数据 。 一 旦 发 送 了 字 节 ， 它 便 通 过 调用 其 Getstream 方法 从 底层 的 System. Net. 
TcpClient 中 获得 NetworkStream 或 者 SsLStream， 然 后 使 用 TcpClient.WriteAsync 方法 发 
送 消 息 。 

为 了 接收 来 自 服务 器 端的 响应 ，MyTcpCLient.ConnectToServerAsync 调用 了 阻塞 的 
TcpClient.ReadAsync 方法 。 一 旦 ReadAsync 返回 ， 字 市 便 被 解码 以 获得 包含 来 自 服务 器 端 
响应 的 字符 串 。 然 后 关闭 连接 ， 客 户 端 结束 。 

要 支持 安全 的 请 求 ， 可 以 在 MyTcpClient 构造 国 数 中 设置 SSLServerName， 用 于 标识 要 用 于 
身份 验证 的 证 书 。 

运行 客户 端的 程序 然后 将 此 名 称 提供 给 类 构造 函数 ， 如 下 所 示 。 


MyTcpClient client = 
new MyTcpClient(IPAddress.Loopback, 55555, "CSharpCookBook.net"); 


当 使 用 一 个 安全 的 连接 时 ， 我 们 使 用 MyTcpClient 的 DisplaySSLInformation 和 
DisplayCertInformation 方法 显示 所 有 连接 的 细节 ， 因 为 它们 涉及 证 书 和 安全 状态 。 


Certficate Information for: 
CN=CShar pCookBook.net 
































Valid From: 
12/27/2014 7:29:31 PM 
Valid To: 

12/31/2039 6:59:59 PM 
Certificate Format: 
X509 


Issuer Name: 

CN=CShar pCookBook.net 

Serial Number: 

QFOE1C4148C6A09C42EDEDAFCD2E83E2 

Hash: 

664E30B62C4FB9DBEEOC29F27A15E5EDE2C46187 

Key Algorithm: 

1.2.840.113549.1.1.1 

Key Algorithm Parameters: 

0500 

Public Key: 
3082020A0282020100EAB6004CD3F2F5214773E8FEA4FA40FE610F1C27E888276E81bEBBB86020B904 
3B136CF02197C928bED0BCA8339A31334059C2744A48BB617849BBC98C8B242FC360C88BF62E2C491B 
1A6F951DDB65E0036D8839AC6695B26CD3E50DD749A5610C8564CF99EE79FED272D04A3100B51A4A 
4BAE076BB8129E39B382ED1FDB8382A2D3C057D7F46072DDDE0654083E1F 2CB4E25685B5EE4B4F25 
F3D2561B61869D9C39B9FB389E6A06D9DEFA6693D94C6A1F2CA34462B3D9C68CF91A179B0957050E 
A9A30D508C067C216CAD59CA9E846B0EBA02472333BBF2462415B13567EBF6930FC1000EECC3EA70 
9867B8BD6869BF828B8bEBA5BA2E4A7660B46B798A8BB8D0OA46FFE1C767F5A77AF1CD6E83F9E013AB1 
748264F89617D9C106813F554B8AF4184AC58B55A1A58ABAA2F171CDBFF6923C27FE801FEE5D3664 
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87F54FAD184B0FCBB874532EC8E6B3BAA322F05DB6AD99E5982B98AD43C0E9BB2356270DB07BA5E5 
AAE2FQB66E630A6A0435FDFC61DB46B0F F348AF5D2285C74A35E8AAFC86F 45COE6 74C2D9FE98B6C1 
17208668CF4B03DD77948AE45AE84D33178C3042B1155E58D3B49492697D5CA4CF4AB24549E4A240 
CCEB6CF61CEF6F33F412A91BC32803136A6481B6B246FEA5A3943EEB7FDA5E54CC561DE737BBB380 
BC2B467F1A5B8CA1BDFC66B6B4E60DCCC7C3912449D0BF8B9878D22C04A36A09898D2AAEDOCE32DB 


770203010001 
SSL Connect Report for 


Is Authenticated: 

Is Encrypted: 

Is Signed: 

Is Mutually Authenticated: 


Hash Algorithm: 
Hash Strength: 
Cipher Algorithm: 
Cipher Strength: 


Key Exchange Algorithm: 
Key Exchange Strength: 


SSL Protocol: 


: CSharpCookBook.net 


True 
True 
True 
False 


Sha1 
160 
Aes256 
256 


44550 
256 


Tls 


Sending message to server: I'll not be ignored! (round 95) 
Server said: Thanks call again! 





#region IDisposable Members 


public void Dispose() 


{ 


Dispose(true); 


在 9.10.2 节 中 ， 我 们 在 MyTCpClient 中 添加 的 IDisposable 接口 的 实现 如 下 所 示 。 





GC. SuppressFinalize(this); 


} 


private void Dispose(bool disposing) 


{ 
if (!_disposed) 
{ 
if (disposing) 
{ 


J 


_disposed = true; 


_client?.Close(); 


} 


#endregion 


我 们 这 样 做 是 为 了 正确 地 处 理 私 有 的 TcpClient 实例 变量 




















client 的 关闭 ， 因 为 它 提 供 


了 自己 的 Close 方法， 以 便 执行 一 些 日 志 记录 并 清理 其 资产。 在 Dispose 方法 中 调用 了 
SuppressFinalize 以 通知 垃圾 回收 器 该 对 象 已 被 完全 清理 。 
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9.10.4 84 


MSDN 文档 中 的 “TcpCLient 2E” *sslstream 2E” “NetworkStream 2E" * 


Y 


和 “Encoding.ASCII 属性 ”主题 。 


9.11 模拟 表单 执行 


9.11.1 问题 





‘IDisposable 接口 ” 





你 需要 发 送 一 个 名 称 / 值 对 集合 到 一 个 URL 所 指定 的 位 置 ， 以 模拟 一 个 表单 在 浏览 如 中 的 


执行 。 


9.11.2 ”解决 方案 





使 用 System.Net.WebClient 类 的 UploadValues 方法 向 Web 服务 器 发 送 一 组 名 称 / 值 对 。 该 





类 通过 使 用 输入 数据 设置 名 称 / 值 对 ， 使 得 你 假装 成 执行 一 个 表单 的 浏 
是 名 称 ， 而 域 中 使 用 的 值 是 值 。 
// 为 了 使 用 此 代码 ,首先 需要 运行 CSCBWeb 项 目 


Uri uri = new Uri("http://localhost:4088/WebForm1.aspx") ; 
WebClient client = new WebClient(); 








// 创建 一 系列 名 称 / 值 对 以 发 送 
// 将 必要 的 参数 / 值 对 添加 到 名 称 / 值 容器 中 
NameValueCollection collection = new NameValueCollection() 
{ {"Item", "WebParts"}, 
{"Identity", "foo@bar.com"}, 
("Quantity", "5") J; 





Console.WriteLine( 
$"Uploading name/value pairs to URI {uri.AbsoluteUri} ..."); 


// 上 传 NameVaLueCoLLection 
byte[] responseArray = 
await client.UploadValuesTaskAsync(uri, "POST", collection); 


// 解码 并 显示 响应 


Console.WriteLine( 





Side. MAIRAJ ID 


$"\nResponse received was {Encoding.UTF8.GetString(responseArray)}"); 


接收 和 处 理 该 数据 的 WebForml.aspx 页 面 如 下 所 示 。 


<%@ Page Language="C#" AutoEventWireup="true" CodeFile="WebForm1 
Inherits="WebForm1" %> 


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http: //www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 


«html xmlns="http: //www.w3.org/1999/xhtmL"> 
<head runat="server"> 


.aspx.cs" 
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<title>Untitled Page</title> 
</head> 
<body> 
«form id="form1" runat="server"> 
<div> 


«asp:Table ID="Table1" runat="server" Height="139px" Width="361px"> 
«asp:TableRow runat="server"> 
«asp:TableCell runat="server"><asp:Label ID="Label1" 
runat="server" 
Text="Identity"></asp:Label></asp:TableCell> 
«asp:TableCell runat="server"><asp:TextBox ID="Identity" 
runat="server'"/></asp:TableCell> 
</asp:TableRow> 
<asp:TableRow runat="server"> 
«asp:TableCell runat="server"><asp:Label ID="Label2" 
runat="server" 
Text="Item"></asp:Label></asp:TableCell> 
«asp:TableCell runat="server"><asp:TextBox ID="Item" 
runat="server" /></asp:TableCell> 
</asp:TableRow> 
<asp:TableRow runat="server"> 
«asp:TableCell runat="server"><asp:Label ID="Label3" 
runat="server" 
Text="Quantity"></asp:Label></asp:TableCell> 
«asp:TableCell runat="server"><asp:TextBox ID="Quantity" 
runat="server'"/></asp:TableCell> 
</asp:TableRow> 
«asp:TableRow runat="server"> 
«asp:TableCell runat="server"></asp:TableCell> 
«asp:TableCell runat="server"><asp:Button ID="Button1" 
runat="server" 
onclick-"Buttoni Click" Text="Submit" /></asp:TableCell> 
</asp:TableRow> 
</asp:Table> 


</div> 

</form> 
</body> 
</html> 


背后 的 WebForml.aspx.cs 代码 如 下 所 示 。 


using System; 
using System.Web; 


public partial class WebForm1 : System.Web.UI.Page 


{ 
protected void Page_Load(object sender, EventArgs e) 
{ 
if(HttpContext.Current.Request.HttpMethod.ToUpper() == "POST") 
WriteOrderResponse(); 
} 


protected void Button1_Click(object sender, EventArgs e) 
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{ 


WriteOrderResponse(); 


} 

private void WriteOrderResponse() 

{ 
string response = "Thanks for the order!<br/>"; 
response += "Identity: " + Request.Form["Identity"] + "<br/>"; 
response += "Item: " + Request.Form["Item"] + "<br/>"; 
response += "Quantity: " + Request.Form["Quantity"] + "<br/>"; 
Response.Write(response) ; 

} 


} 





表单 执行 的 输出 如 下 所 示 。 





Uploading name/value pairs to URI http://localhost:4088/WebFormi.aspx ... 


Response received was ?Thanks for the order!<br/>Identity: foo@bar.com<br/>Item: 
WebParts<br/>Quantity: 5<br/> 


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http: //www.w3.or 
g/TR/xhtml1/DTD/xhtml1-transitional.dtd"- 


«html xmlns-z"http://www.w3.0rg/1999/xhtml"» 
<head><title> 
Untitled Page 

</title></head> 
<body> 

«form name="form1" method="post" action="WebForm1.aspx" id-"formi"» 
<input type="hidden" name="__VIEWSTATE" id="__VIEWSTATE" value="/wEPDWULLTE3NDA4 
NzI10TJkZHS2esbeFu360Kf1n3XvCfLBFbminq7tuASWazSmVzNV" /> 


<div> 


«table id="Table1" border="0" height="139" width="361"> 
<tr> 
<td><span id="Label1">Identity</span></td><td><input name="Ident 
ity" type="text" id="Identity" /></td> 
</tr><tr> 
<td><span id="Label2">Item</span></td><td><input name="Item" typ 
e="text" id="Item" /></td> 
</tr><tr> 
<td><span id="Label3">Quantity</span></td><td><input name="Quant 
ity" type="text" id="Quantity" /></td> 
</tr><tr> 
<td></td><td><input type="submit" name="Button1" value-"Submit" 
id="Button1" /></td> 
</tr> 
</table> 


</div> 


<input type="hidden" name="__VIEWSTATEGENERATOR" id="__VIEWSTATEGENERATOR" value 
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-"B6E7D48B" /> 

<input type="hidden" name-"  EVENTVALIDATION" id-"  EVENTVALIDATION" value="/wEd 
AAWO/d jOxplxW6YoKRXH5OHbmz / p L7ppA227nN6820C6Sskwyh j63BXMkV5ahbRAQpWWUa LLXbdbKxLN 
IxdB86x«zfg78Z8BXhXifTCAVkevd657ebmKY jtae5uEq9PVWdORhH/uhX8f6dI/Hiyyipi4" /></fo 


rm» 

«!-- Visual Studio Browser Link --» 

«script type-"application/json" id="__browserLink_initializationData"> 
("appName" : "Unknown" , "requestId":"c7ee16b51c9b4bccae0c3c79a9fba779") 

</script> 


<script type="text/javascript" src="http://localhost:2976/eef9532a4f984be0b28884 
3bb4cee559/browserLink" async="async"></script> 
<!-- End Browser Link --> 


</body> 
</html> 


9.11.3 讨论 

WebClient 类 使 得 以 名 称 / 值 对 的 常用 格式 将 表单 数据 上 传 到 Web 服务 器 变 得 很 简单 。 
你 可 以 通过 使 用 一 个 URI (http:Wlocalhost:4088/WebForml.aspx)， 选 用 的 HTTP 方法 
(POST) 和 你 创建 的 NameValueCollection (collection) 调用 UploadValuesTaskAsync 来 
了 解 该 技术 。 





UploadValues* 方法 的 异步 版 本 被 调用 ， 并 且 所 用 的 方法 (UploadValuesTaskAsync ) 
是 用 于 async 和 await 的 特定 方法 。 











通过 调用 其 Add 方 法， 传递 输入 域 的 启 作 为 名 称 以 及 放 和 域 中 的 值 作为 值 ， 
NameValueCollection 被 十 入 表单 中 每 个 域 中 的 数据 。 在 本 示例 中 ， 你 在 Identity 域 中 填 
入 foo@bar.com, {E Item 域 中 填 入 Book， 在 Quantity 域 中 填 入 5。 然 后 在 控制 台 窗 口中 输 
出 来 自 POST 的 响应 结果 。 

911.4 参考 


MSDN 文档 中 的 “WebcClient 类 ”主题 。 


9.12 通过 HTTP 传 输 数 据 


9.12.1 问题 


你 需要 从 一 个 URL 指定 的 位 置 上 下 载 或 上 传 数据 ， 该 数据 可 能 是 一 个 字 市 数组 或 者 一 个 
文件 。 
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9.12.2 ”解决 方案 


使 用 WebClient.UploadDataTaskAsync 或 WebClient.DownloadDataTaskAsync 方法 使 用 一 个 
URL 传输 数据 。 


要 从 一 个 网 页 下 载 数据 ， 请 执行 以 下 操作 。 


Uri uri = new Uri("http://localhost:4088/DownloadData.aspx"); 








// 创建 一 个 客户 端 
using (WebClient client = new WebClient()) 
{ 
// 获得 文件 内 容 
Console.WriteLine($"Downloading {uri.AbsoluteUri}"); 
// 下 载 页 面 并 保存 字 节 数据 
byte[] bytes; 
try 
{ 














// 注意 ,还 有 一 个 DownLoadDataAsync 方 法 ,用 于 旧 的 EAP 模 式 ， 
// 此 处 我 们 不 会 用 到 


bytes = await client.DownloadDataTaskAsync(uri); 

















} 
catch (WebException we) 
{ 
Console.WriteLine(we.ToString()); 
return; 
} 
// 输出 HTML 
string page = Encoding.UTF8.GetString(bytes); 
Console.WriteLine(page) ; 


} 
这 将 产生 下 列 输出 。 


Downloading http://localhost:4088/DownloadData. aspx 
了 


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.or 
g/TR/xhtml1/DTD/xhtml1-transitional.dtd"- 


«html xmlns-z"http://www.w3.0rg/1999/xhtml"» 
<head><title> 
Download Data 
</title></head> 
<body> 
«form name="Form1" method="post" action="DownloadData.aspx" id="Form2"> 
<input type="hidden" name-"  VIEWSTATE" 
vaLue="dDwyMDQwNjUZNDY20zs+kS9hguYm9369sybDqmIow0AvxBg="_ /> 
«span id="Label1" style="Z-INDEX: 101; LEFT: 142px; POSITION: absolute; 
TOP: 164px">This is downloaded html!«/span» 


</form> 
<!-- Visual Studio Browser Link --> 
«script type-"application/json" id="__browserLink_initializationData"> 
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{"appName": "Unknown" , "requestId":"b43b962ff6264058b5dbf17aed23a082") 
</script> 
«script type="text/javascript" src="http://localhost: 3587/db7b63d3424649c7a10386 
29bc71b103/browserLink" async="async"></script> 
<!-- End Browser Link --> 


</body> 
</html> 


你 还 可 以 使 用 DownloadFileTaskAsync 将 数据 下 载 到 一 个 文件 中 。 


Uri uri = new Uri("http://localhost:4088/DownloadData.aspx"); 








// 创建 一 个 客户 端 
using (WebClient client = new WebClient()) 
{ 
// 去 获得 文件 
Console.WriteLine($"Retrieving file from {uri}...{Environment.NewLine}"); 
// 获得 文件 并 放 入 一 个 临时 文件 中 
string tempFile = Path.GetTempFileName(); 
try 
{ 

















// 注意 ,还 有 一 个 DownloadFileAsync 方 法 ,用 于 旧 的 EAP 模 式 ， 
// 此 处 我 们 不 会 用 到 


await client.DownloadFileTaskAsync(uri, tempFile); 





J 


catch (WebException we) 


{ 
Console.WriteLine(we.ToString()); 
return; 


ib 


Console.WriteLine($"Downloaded {uri} to {tempFile}"); 
} 
这 将 产生 下 列 输出 〈 临 时 文件 路 径 和 名 称 将 会 有 所 不 同 ) 。 


Retrieving file from http://localhost:4088/DownloadData.aspx... 





Downloaded http://localhost:4088/DownloadData.aspx to C:\Users\jhilyard\AppData\ 
Local\Temp\tmpA5D7. tmp 


要 将 一 个 文件 上 传 到 一 个 URL 中 ， 可 使 用 UploadFileTaskAsync， 代 码 如 下 所 示 。 


Uri uri = new Uri("http://localhost:4088/UploadData.aspx"); 
// 创建 一 个 客户 端 

using (WebClient client = new WebClient()) 

{ 





Console.WriteLine($"Uploading to {uri.AbsoluteUri}"); 
try 
{ 





// 注意 ,还 有 一 个 UploadFileAsync 方 法 ,用 于 旧 的 EAP 模 式 ， 

// 此 处 我 们 不 会 用 到 

await client.UploadFileTaskAsync(uri, "SampleClassLibrary.dll"); 
Console.WriteLine($"Uploaded successfully to {uri.AbsoluteUri}"); 











} 


catch (WebException we) 
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Console.WriteLine(we.ToString()); 
} 
可 以 接收 上 传 文件 的 ASPX 页 面 代 码 如 下 所 示 。 


using System; 
using System.Web; 














public partial class UploadData : System.Web.UI.Page 
{ 


protected void Page_Load(object sender, EventArgs e) 


{ 
foreach (string f in Request.Files.AllKeys) 


{ 
HttpPostedFile file = Request.Files[f]; 


// 需要 有 写 入 目录 的 写 权限 
try 


{ 











string path = Server.MapPath(".") + Q"V" + file. FileName; 
file.SaveAs(path); 
Response.Write("Saved " + path); 


catch (HttpException hex) 


{ 














// 返回 保存 文件 的 特定 错误 信息 
Response.Write("Failed to save file with error: " + 
hex.Message); 











虽然 上 述 ASPX 页 面 将 接收 和 存储 文件 ， 这 只 是 为 了 说 明 使 用 WebClient 
上 传 的 基本 示例 。 当 构建 能 够 接收 文件 的 页 面 时 ， 请 确保 处 理 了 文件 上 传 
安全 方面 的 问题 ， 如 OWASP (开放 式 Web 应 用 程序 安全 项 目 ) 在 其 网 站 
(https:/www.owasp.org/index.php/Unrestricted_File_Upload) 上 描述 的 未 限制 
的 文件 上 传 漏洞 。 























这 将 产生 如 下 输出 。 


Uploading to http://localhost:4088/UploadData. aspx 
Uploaded successfully to http://localhost:4088/UploadData. aspx 


9.12.3 讨论 


WebClient 简化 了 文件 和 文件 中 字 节 的 下 载 ， 因 为 在 处 理 Web 时 它们 都 是 常见 的 任务 。 更 
传统 的 用 于 下 载 的 基于 流 的 方法 也 可 以 通过 WebClient 上 的 OpenReadTaskAsync 方法 访问 。 























9.12.4 参考 
MSDN 文档 中 的 “WebClient 类 ”主题 和 OWASP 网 站 (https://www.owasp.org/) 。 


9.13 ”使 用 命名 管道 进行 通信 


9.13.1 问题 
你 需要 一 种 使 用 命名 管道 通过 网 络 与 另 一 应 用 程序 进行 通信 的 方法 。 


9.13.2 解决 方案 


使 用 System.I0.Pipes 命名 空间 中 的 NamedPipeClientStream 和 NamedPipeServerStream。 然 
后 可 以 创建 一 个 客户 端 和 服务 器 端 来 使 用 命名 管道 。 

为 了 使 用 NamedPipeClientStream 类 ， 你 需要 类 似 于 例 9-6 中 所 示 的 某 些 代码 。 

例 9-6: 使 用 NamedPipeClientStream 类 


using System; 

using System.Text; 

using System.IO.Pipes; 

using System.Threading.Tasks; 











namespace NamedPipes 




















{ 
class NamedPipeClientConsole 
{ 
static void Main() 
{ 
Task client = RunClient(); 
client.Wait(); 
Console.WriteLine("Press Enter to exit..."); 
Console.ReadLine(); 
} 
private static async Task RunClient() 
{ 
Console.WriteLine("Initiating client, looking for server..."); 
// 设置 一 个 要 发 送 的 消息 
string messageText = "Sample text message!"; 


int bytesRead; 





// 设置 一 个 命名 管道 客户 端 ,并 在 完成 之 后 关闭 它 
using (NamedPipeClientStream clientPipe = 


new NamedPipeClientStream(".", "mypipe", PipeDirection.InOut, 
PipeOptions.None)) 








// 连接 至 服务 器 的 流 
await clientPipe.ConnectAsync(); 


// 将 读 取 模式 设置 为 nessage 
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we 


clientPipe.ReadMode = PipeTransmissionMode.Message; 


I] 写 入 十 次 消息 


for (int i = 0; i < 10; i++) 


{ 


Console.WriteLine($"Sending message: {messageText}"); 

byte[] messageBytes = Encoding.Unicode.GetBytes(messageText) ; 
// 检查 并 写 入 消息 
if (clientPipe.CanWrite) 


























{ 
await clientPipe.WriteAsync( 
messageBytes, 0, messageBytes.Length); 
await clientPipe.FlushAsync(); 
// 等 待 直到 被 读 取 
clientPipe.WaitForPipeDrain(); 
} 











// AS API Beh 
messageBytes = new byte[256]; 
do 


{ 





Dsl 





























// 将 消息 收集 到 字符 串 生 成 器 中 


StringBuilder message = new StringBuilder(); 


// 读 取 所 有 数据 ,直到 获得 
// 完整 的 消息 响应 

do 
f 





























// 从 管道 中 读 取 
bytesRead = 
await clientPipe.ReadAsync( 
messageBytes, 0, messageBytes.Length); 
// 如 果 获 得 了 数据 ,将 其 添加 到 消息 中 
if (bytesRead > 0) 





{ 
message.Append( 
Encoding.Unicode.GetString(messageBytes, 0, 
bytesRead) ); 
Array.Clear(messageBytes, 0, messageBytes.Length) ; 
} 


j 


while (!clientPipe.IsMessageComplete); 























// 既然 已 读 取 了 整 条 消息 ,将 其 设置 为 0 

bytesRead = 0; 

Console.WriteLine($" Received message: 
$"{message.ToString()}"); 


+ 


} 
while (bytesRead != 0); 





然后 ， 为 了 建立 一 个 与 客户 端 通话 的 服务 器 ， 可 使 用 NamedPipeServerStream 类 ， 如 例 9-7 
所 示 。 


例 9-7: 为 客户 端 建立 一 个 服务 器 
using System; 
using System.Text; 
using System.IO.Pipes; 
using System.Threading.Tasks; 


namespace NamedPipes 














{ 
class NamedPipeServerConsole 
{ 
static void Main() 
{ 
Task server = RunServer(); 
server .Wait(); 
// 使 服务 器 挂 起 ,以 便 看 到 发 送 的 消息 
Console.WriteLine("Press Enter to exit..."); 
Console.ReadLine(); 
} 


private static async Task RunServer() 


{ 


Console.WriteLine("Initiating server, waiting for client..."); 

// 以 message 模 式 启 动 命名 管道 ,并 在 完成 之 后 关闭 管道 

using (NamedPipeServerStream serverPipe = new 
NamedPipeServerStream("mypipe", PipeDirection.InOut, 1, 
PipeTransmissionMode.Message, PipeOptions.None)) 


// 等 待 一 个 客户 端 …… 
await serverPipe.WaitForConnectionAsync(); 


























// 处 理 消息 ,直到 客户 端 断 开 连接 
while (serverPipe.IsConnected) 


( 

















int bytesRead - 0; 
byte[] messageBytes - new byte[256]; 
// 读 取 , 直 到 获得 了 消息 ,然后 进行 响应 
do 
{ 





























// 构建 客户 端 消息 


StringBuilder message = new StringBuilder(); 








// 检查 是 否 可 读 取 管 道 
if (serverPipe.CanRead) 
{ 

// 人 循环 直到 整 条 消息 被 读 取 

do 

{ 

bytesRead = 
await serverPipe.ReadAsync(messageBytes, 0, 
messageBytes.Length); 
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// 从 流 中 获得 了 字 节 ,所 以 添加 到 消息 中 
if (bytesRead > 0) 














{ 
message. Append( 
Encoding.Unicode.GetString(messageBytes, 0, 
bytesRead) ); 
Array.Clear(messageBytes, 0, 
messageBytes.Length) ; 
} 


j 


while (!serverPipe.IsMessageComplete); 


j 


// 如 果 我 们 收 到 了 一 条 消息 ,输出 它 然 后 回应 
if (message.Length > 0) 

























































































{ 

// 既然 已 读 到 整 条 消息 ,将 其 设置 为 6 

bytesRead = 0; 

Console.WriteLine($"Received message: " + 
$"(nessage.ToString()]"); 

// 翻转 从 客户 端 收 到 的 消息 文本 并 返回 

char[] messageChars = 
message.ToString().Trim().ToCharArray(); 

Array.Reverse(messageChars) ; 

string reversedMessageText = new string(messageChars); 

// 显示 返回 的 消息 

Console.WriteLine($" Returning Message: " + 
$"{{reversedMessageText}"); 

// 输出 回应 

messageBytes = Encoding.Unicode.GetBytes(messageChars); 

if (serverPipe.CanWrite) 

{ 
// 输出 消息 
await serverPipe.WriteAsync(messageBytes, 0, 

messageBytes.Length) ; 

// 刷新 缓冲 区 
await serverPipe.FlushAsync(); 
// 等 待 客户 端 读 取 
serverPipe.WaitForPipeDrain(); 

} 

} 


} 
while (bytesRead != 0); 





9.13.3 讨论 


命名 管道 是 Windows 上 一 种 允许 进程 间或 机 器 间 进 行 通信 的 机 制 。.NET Framework 中 提 
供 了 对 命名 管道 的 托管 访问 ， 这 使 得 在 托管 应 用 程序 中 使 用 命名 管道 变 得 更 加 简单 。 在 许 
多 情况 下 ， 你 可 以 使 用 Windows Communication Foundation (WCF) 建立 服务 器 和 客户 端 
代码 ，WCF 甚至 提供 了 一 个 命名 管道 绑 定 以 完成 这 一 工作 。 这 取决 于 用 户 应 用 程序 需求 
以 及 你 希望 在 应 用 程序 栈 的 哪个 级 别 上 工作 。 Mop ean 道 的 应 用 
程序 ， 那 么 当 你 能 够 直接 连接 时 为 什么 要 使 用 WCF We? 使 用 命名 管道 类 似 于 使 用 套 接 字 
并 保持 代码 贴近 于 管道 。 这 样 做 的 好 处 在 于 需 处 理 的 代码 层次 较 少 ， B AE 
方面 必须 做 更 多 的 工作 。 


在 解决 方案 中 ， 我 们 创建 了 某 些 使 用 NamedPipeClientStream 和 NamedPipeServerStream 的 
代码 。 它 们 之 间 的 交互 如 下 所 示 。 


(1) 服 务 器 进程 启动 ， 它 创建 一 个 NamedPipeCLientStream， 然 后 调用 WaitForConnection- 


Async 等 待 某 一 客户 端 来 连接 : 
// 以 message 模 式 启 动 命名 管道 ,并 在 完成 之 后 关闭 管道 


using (NamedPipeServerStream serverPipe = new 
NamedPipeServerStream("mypipe", PipeDirection.InOut, 1, 
PipeTransmissionMode.Message, PipeOptions.None)) 


































































































// 等 待 一 个 客户 端 …… 
await serverPipe.WaitForConnectionAsync(); 


(2) AMY mide ee OE, EONA NamedPipeClientStream, AF ConnectAsync 并 与 服务 
器 进程 连接 : 
// 设置 一 个 命名 管道 客户 端 ,并 在 完成 之 后 关闭 它 
using (NamedPipeClientStream clientPipe = 


new NamedPipeClientStream(".","mypipe", 
PipeDirection.InOut,PipeOptions.None)) 

















// 连接 至 服务 器 的 流 
await clientPipe.ConnectAsync(); 
(3) 服 务 器 端 进程 看 到 来 自 客户 端的 连接 ， 然 后 在 一 个 查找 来 自 客户 端 消息 的 循环 中 调用 
IsConnected, H ENEZ I: 
// 处 理 消息 ,直到 客户 端 断 开 连 接 


while (serverPipe. IsConnected) 


















































{ 
// 此 处 略 掉 更 多 的 处 理 代 码 ……: 
} 
(4) 客户 端 进程 然 后 使 用 WriteAsync, FlushAsync 和 WaitForPipeDrain 向 服务 器 端 进 程 写 入 
若干 消息 : 
string messageText = "Sample text message!"; 


// 写 入 十 次 消息 


for (int i = 0; i < 10; i++) 
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Console.WriteLine($"Sending message: {messageText}"); 

byte[] messageBytes = Encoding.Unicode.GetBytes(messageText); 
// 检查 并 写 入 消息 

if (clientPipe.CanWrite) 























{ 
await clientPipe.WriteAsync( 
messageBytes, 0, messageBytes.Length); 
await clientPipe.FlushAsync(); 
// 等 待 直到 被 读 取 
clientPipe.WaitForPipeDrain(); 
} 


// 响应 处 理 ……: 





} 
(5) 当 客 户 端 进程 接收 到 来 自 服务 器 的 响应 时 ， 它 读 取 消息 字 节 直至 全 部 完成 。 如 果 消 息 发 
送 完 成 ， 那 么 NamedPipeClientStream 跳出 using 语句 的 作用 域 并 关闭 (因此 关闭 客户 
端的 连接 )， 然 后 等 待 用 户 按 下 回 车 键 以 便 退 出 : 


// 设置 一 个 用 于 消息 字 节 的 缓冲 
messageBytes = new byte[256]; 























Pl 



































do 
{ 
// 将 消息 收集 到 字符 串 生 成 器 中 
StringBuilder message = new StringBuilder(); 
// 读 取 所 有 数据 ,直到 获得 完整 的 消息 响应 
do 
{ 


// 从 管道 中 读 取 
bytesRead = 
await clientPipe.ReadAsync( 
messageBytes, 0, messageBytes.Length); 
// 如 果 获 得 了 数据 ,将 其 添加 到 消息 中 
if (bytesRead > 0) 





























{ 
message.Append( 
Encoding.Unicode.GetString(messageBytes, 0, 
bytesRead) ); 
Array.Clear(messageBytes, 0, messageBytes.Length) ; 
} 


while (!clientPipe.IsMessageComplete); 




















// 既然 已 读 取 了 整 条 消息 ,将 其 设置 为 0 
bytesRead = 0; 
Console.WriteLine($" Received message: {message.ToString()}"); 





} 
while (bytesRead != 0); 


(6) 服务 器 进程 通过 white 循环 中 失败 的 IsConnected 14 3:38: BI Pm AK T 38 
f£, NamedPipeServerStream 跳出 using 语句 的 作用 域 ， 并 关闭 管道 。 


客户 端 输出 如 下 所 示 。 





[es 
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PipeOptions 枚 举 控制 管道 操作 如 何 运行 。 枚 举 值 如 表 9-3 所 示 。 


Initiating client, looking for server... 
Sending message: Sample text message! 
Received message: !egassem txet elpmaS 
Sending message: Sample text message! 
Received message: !egassem txet elpmaS 
Sending message: Sample text message! 
Received message: !egassem txet elpmaS 
Sending message: Sample text message! 
Received message: !egassem txet elpmaS 
Sending message: Sample text message! 
Received message: !egassem txet elpmaS 
Sending message: Sample text message! 
Received message: !egassem txet elpmaS 
Sending message: Sample text message! 
Received message: !egassem txet elpmaS 
Sending message: Sample text message! 
Received message: !egassem txet elpmaS 
Sending message: Sample text message! 
Received message: !egassem txet elpmaS 
Sending message: Sample text message! 
Received message: !egassem txet elpmaS 
Press Enter to exit... 


服务 器 输出 如 下 列 示 。 


Initiating server, waiting for client... 
Received message: Sample text message! 
Returning Message: !egassem txet elpmaS 
Received message: Sample text message! 
Returning Message: !egassem txet elpmaS 
Received message: Sample text message! 
Returning Message: !egassem txet elpmaS 
Received message: Sample text message! 
Returning Message: !egassem txet elpmaS 
Received message: Sample text message! 
Returning Message: !egassem txet elpmaS 
Received message: Sample text message! 
Returning Message: !egassem txet elpmaS 
Received message: Sample text message! 
Returning Message: !egassem txet elpmaS 
Received message: Sample text message! 
Returning Message: !egassem txet elpmaS 
Received message: Sample text message! 
Returning Message: !egassem txet elpmaS 
Received message: Sample text message! 
Returning Message: !egassem txet elpmaS 
Press Enter to exit... 





389-3; Pipe0ptions 枚 举 值 





成 员 名 jo x 
None 未 指定 特定 选项 
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(5x) 


















































成 员 名 描 xk 

WriteThrough 当 向 管道 写 人 时 ， 操 作 不 返回 控制 ， 直 至 在 服 完成 号 入 。 没 有 该 标志 ， 写 入 会 
被 缓冲 ， 并 且 写 入 的 返回 更 快速 

Asychronous 启用 异步 管道 使 用 (调用 立即 返回 并 在 后 台 进 行 处 理 ) 

9134 参 

MSDN 文档 中 的 “命名 管道 ”“NamedPipeCLientStream 3” “NamedPipeServerStream 2 ” 





和 “System.I0.Pipes 命名 空 ea 主题 
9.14 ”以 编程 方式 发 送 ping 


9.14.1 问题 
你 希望 检查 网 络 中 一 台 计 算 机 的 可 用 性 。 


9.14.2 ”解决 方案 


使 用 System.Net.NetworkInformation.Ping 类 确定 一 台 机 器 是 否 可 用 。 在 TestPing 方 法 
中 ， 创 建 Ping 类 的 一 个 实例 。 使 用 Send 方法 发 送 一 个 ping 请 求 。SendPingAsync 方法 
是 异步 的 ， 并 且 在 await 等 待 后 返回 一 个 可 检查 ping 结果 的 PingReply。 也 可 以 在 挂 接 
Ping 类 的 PingCompleted 事件 之 后 ， 异 步 地 使 用 旧 的 SendAsync 方法 执行 第 二 个 ping 请 
求 。SendAsync 方法 的 第 二 个 参数 保存 了 一 个 用 户 令 牌 值 ， 当 ping 结束 时 返回 到 pinger_ 
PingCompleted 事件 处 理 程 序 。 

在 async 和 await 对 你 可 用 时 应 当 使 用 SendPingAsync, 但 是 如 果 你 在 旧 的 框架 中 进行 此 操 
TE, BBA SendAsync 是 你 唯一 的 异步 选项 。 返 回 的 令 牌 可 用 于 识别 初始 代码 和 结束 代码 之 
间 的 请 求 。 


public static async Task TestPing() 


{ 
































System.Net.NetworkInformation.Ping pinger = 

new System.Net.NetworkInformation.Ping(); 
PingReply reply = await pinger.SendPingAsync("www.oreilly.com"); 
DisplayPingReplyInfo(reply); 


pinger.PingCompleted += pinger PingCompleted; 
pinger.SendAsync("www.oreilly.com", "oreilly ping"); 


} 


DisplayPingReplyInfo 方法 展示 了 你 希望 从 ping 中 获得 的 更 常用 的 数据 片段 ， 诸 如 
RoundtripTime 和 回复 的 Status。 这 些 可 通过 PingReply 上 的 那些 属性 访问 。 








private static void DisplayPingReplyInfo(PingReply reply) 
{ 





Console.WriteLine("Results from pinging 
Console.WriteLine( 

$"\tFragmentation allowed?: {!reply.Options.DontFragment}"); 
Console.WriteLine($"\tTime to live: {reply.Options.Ttl}"); 
Console.WriteLine($"\tRoundtrip took: {reply.RoundtripTime}") ; 
Console.WriteLine($"\tStatus: {reply.Status.ToString()}"); 


+ reply.Address); 


} 


用 于 PingCompleted 的 事件 处 理 程 序 是 pinger_PingCompleted 方 法 。 该 事件 处 理 
程序 遵循 发 送 方 对 象 和 事件 参数 的 一 般 EventHandler 约定 。 该 事件 的 参数 类 型 
是 PingCompletedEventArgs。PingReply 可 通过 事件 参数 的 Reply 属 性 访问 。 如 果 
ping 被 取消 或 者 引发 一 个 异常 ， 那 么 该 信息 可 通过 Cancelled fü Error 属性 访问 。 
PingCompletedEventArgs 类 上 的 UserState 属性 持 有 SendAsync 中 提供 的 用 户 令 牌 值 。 


private static void pinger_PingCompleted(object sender, PingCompletedEventArgs e) 


( 











PingReply reply = e.Reply; 
DisplayPingReplyInfo(reply); 


if (e.Cancelled) 
Console.WriteLine($"Ping for {e.UserState.ToString()} was cancelled"); 
else 
Console.WriteLine( 
S"Exception thrown during ping: {e.Error?.ToString()}"); 


} 
DisplayPingReplyInfo 的 输出 如 下 所 示 。 


Results from pinging 23.3.106.121 
Fragmentation allowed?: True 
Time to live: 60 
Roundtrip took: 13 
Status: Success 





9.14.3 iit 


Ping 使 用 一 个 RFC 792 定义 的 互联 网 控制 消息 协议 (ICMP) 中 的 echo 请 求 消息 。 如 果 
ping 请 求 未 能 成 功 到 达 一 台 计 算 机 ， 这 并 不 能 意味 着 该 计算 机 是 不 可 访问 的 。 除 了 机 器 离 
线 之 外 ， 还 有 许多 因素 会 阻止 一 个 ping 成 功 到 达 。 网 络 拓 扑 、 防 火 墙 、 包 过 滤器 以 及 代理 
服务 器 都 可 能 中 断 ping 请 求 的 正常 流 。Windows 防火 墙 默认 禁止 ICMP 通信 ， 因 此 如 果 你 
发 送 ping 到 一 台 机 器 时 遇 到 困难 ， 请 检查 该 机 器 上 的 防火 墙 设置 。 















































9.14.4 参考 
MSDN 文档 中 的 “Ping 类 ”“PingReply 类 ”和 “PingCompleted 事件 ”主题 。 
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9.15 ”使 用 SMTP 服 务 发 送 SMTP 邮 件 


9.15.1 问题 


你 希 


望 能 够 从 自己 的 程序 通过 SMTP 发 送 电 子 邮件 ， 但 不 想 学 习 SMTP 协议 并 手动 编写 一 





个 类 去 实现 它 。 


9.15.2 ”解决 方案 


使 用 System.Net.Mail 命名 空间 ， 其 中 包含 了 处 理 构 建 一 个 基于 SMTP 的 电子 邮件 消息 
的 较 难 部 分 的 类 。System.Net.Mail.MailMessage 类 封装 了 对 一 个 基于 SMTP 的 消息 的 
构建 ， 而 System.Net.Mail.SmtpClient 类 提供 了 向 SMTP 服务 器 发 送 消息 的 发 送 机 制 。 
SntpClient 依赖 在 某 处 建立 一 个 消息 中 继 的 SMTP 服务 器 。 可 以 通过 创建 System.Net. 
Mail.Attachment 的 实例 并 提供 指向 文件 的 路 径 以 及 媒体 类 型 来 添加 附件 ， 代 码 如 下 所 示 。 








// 发 送 一 个 包含 附件 的 消息 
string from = "authorsQoreilly.com"; 
string to = "authorsQoreilly.com"; 
MailMessage attachmentMessage = new MailMessage(from, to); 
attachmentMessage.Subject = "Hi there!"; 
attachmentMessage.Body = "Check out this cool code!"; 
// 许多 系统 过 滤 通 过 中 继 的 HTML 邮 和 件 
attachmentMessage.IsBodyHtml = false; 
// 设置 附件 
string pathToCode = @"..\..\@9_NetworkingAndWeb.cs"; 
Attachment attachment = 

new Attachment(pathToCode, 

MediaTypeNames.Application.Octet); 

attachmentMessage.Attachments.Add(attachment); 

















// 或 者 仅 发 送 文本 
MailMessage textMessage = new MailMessage("authorsQoreilly.com", 
"authors@oreilly.com", 


"Me again", 
"You need therapy, talking to yourself is one thing but 
writing code to send email is a whole other thing..."); 


要 发 送 一 个 不 带 附 件 的 简单 电子 邮件 ， 可 以 仅 用 收 件 地 址 、 发 件 地 址 、 主 题 和 正文 信息 调 
用 System.Net.Mail.MailMessage 构造 函数 。MailMessage 构造 函数 的 这 一 版 本 简单 地 填充 
这 些 项 目 ， 然 后 可 以 将 其 传递 给 SntpClient.Send 进行 发 送 ， 代 码 如 下 所 示 。 























// 如 果 本 地 存在 一 个 SMTP 服 务 , 你 就 能 够 从 本 地 SMTP 服 务 发 出 去 
// 本 地 的 SMTP 服 务 需 要 设置 为 中 继 到 一 个 真正 的 

// 邮件 服务 器 ,如 同 你 在 IIS6 中 进行 的 设置 

//SmtpClient client = new SmtpClient("localhost"); 


























// 既然 我 们 生活 在 一 个 更 加 有 安全 意识 的 时 代 ,我 们 可 以 提供 正确 的 参数 
// 以 连接 到 SMTP 服 务 器 ,包括 主机 名 、 

// 端口 .已 启用 的 SSL, 以 及 你 的 凭据 

// 注意 ,如 果 你 没有 替换 当前 值 ,就 会 得 到 一 个 
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BOR 


// 如 下 所 示 的 异常 : 

// System.Net.Mail.SmtpException: The SMTP host was not found. ---> 
// System.Net.WebException: The remote name could not be resolved: 

// 'YOURSMTPSERVERHERE ' 

using (SmtpClient client = new SmtpClient("YOURSMTPSERVERHERE", 999)) 





{ 
client.EnableSsl = true; 
client.Credentials = new NetworkCredential("YOURSMTPUSERNAME" , 
// "YOURSMTPPASSWORD") ; 
await client.SendMailAsync(attachmentMessage) ; 
} 


9.15.3 iit 


如 RFC 821 中 所 定义 ，SMTP 代表 简单 邮件 传输 协议 。 为 了 使 用 System.Net.Mait， 
SmtpClient 类 来 利用 NET Framework 对 SMTP 的 支持 ， 必 须 指定 一 个 进行 消息 中 继 的 
SMTP 服务 器 。 旧 版 本 的 Windows (Windows 8/Windows Server 2012 之 前 版 本 ) rp, 操作 
系统 带 有 一 个 可 作为 IS 的 一 部 分 安装 的 SMTP 服务 器 。 在 9.15.2 "rp, SntpClient 通过 
为 要 连接 的 服务 器 指定 "tlocalhost" 来 使 用 这 一 功能 ， 代 表 本 地 机 器 是 SMTP 中 继 服务 器 。 
在 你 的 网 络 环境 中 建立 SMTP 服务 器 也 许 不 可 能 ， 你 可 能 需要 使 用 SmtpClient 类 建立 凭据 
来 直接 与 网 络 上 的 SMTP 服务 器 连接 ， 如 9.15.2 节 所 示 。 


using(SmtpClient client = new SmtpClient("YOURSMTPSERVERHERE" ,999)) 























{ 
client.EnableSsl = true; 
client.Credentials = new NetworkCredential("YOURSMTPUSERNAME" , 
// "YOURSMTPPASSWORD") ; 
await client.SendMailAsync(attachmentMessage); 
} 





9.15.2 市 中 用 到 的 MediaTypeNames 类 确定 了 附件 类 型 。 有 效 的 附件 类 型 如 表 9-4 所 列 。 
表 9-4: MediaTypeNames .Attachment 值 


名 称 dO x 
Octet 数据 未 被 指定 为 任何 特定 类 型 

















Pdf 数据 是 便携 式 数据 格式 (portable data format) 
Rtf 数据 是 RTF 格式 (rich text format) 
Soap 数据 是 一 个 SOAP 文档 
Zip 数据 是 被 压缩 的 
9154 ”参考 


MSDN 文档 中 的 “Using SMTP for Outgoing Messages" “SmtpMail 类 ”“MailMessage % ” 
Fu “MailAttachment 类 ”主题 。 





网 络 和 Web | 387 


9.16 使 用 套 接 字 扫 描 机 器 的 端口 


9.16.1 问题 
你 希望 确定 一 台 机 器 上 打开 的 端口 ， 以 查看 安全 风险 的 位 置 。 


9.16.2 ”解决 方案 


为 此 可 使 用 CheapopPortScanner 类 ， 其 代码 如 例 9-8 所 示 。CheapoPortScanner 使 用 
Socket 类 尝试 打开 一 个 套 接 字 并 连接 某 一 地 址 上 的 指定 端口 。ScanAsync 方法 支持 通 
过 IProgress«T» 报告 在 CheapoPortScanner 构造 函数 中 指定 的 端口 范围 或 默认 范围 
(1~65535) 内 的 每 个 端口 的 进展 。CheapoPortScanner 默认 将 扫描 本 地 机 器 。 


例 9-8: CheapoPortScanner 类 
public class CheapoPortScanner 


{ 

















#region Private consts and members 
private const int PORT_MIN_VALUE = 1; 
private const int PORT_MAX_VALUE = 65535; 
private List<int> _openPorts; 

private List<int> _closedPorts; 
#endregion 


值得 一 提 的 是 CheapoPortScanner 上 的 两 个 属性 。0penPorts 和 ClosedPorts 属性 返回 一 个 
类 型 为 int 的 Read0nLyCoLLection， 分 别 为 包含 打开 的 和 关闭 的 端口 列表 。 其 代码 如 例 9-9 
所 示 。 


例 9-9: OpenPorts 和 ClosedPorts 属性 


#region Properties 

public ReadOnlyCollection<int> OpenPorts => 
new ReadOnlyCollection<int>(_openPorts) ; 

public ReadOnlyCollection<int> ClosedPorts => 
new ReadOnlyCollection«int»( closedPorts); 








public int MinPort { get; } = PORT MIN VALUE; 
public int MaxPort { get; } = PORT MAX VALUE; 
public string Host { get; } = "127.0.0.1"; // localhost 


#endregion // Properties 

#region CTORs & Init code 

public CheapoPortScanner() 

{ 
// 端口 和 本 地 主机 已 作为 默认 设置 
SetupLists(); 








j 


public CheapoPortScanner(string host, int minPort, int maxPort) 
{ 
if (minPort > maxPort) 
throw new ArgumentException("Min port cannot be greater than max port"); 
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if (minPort < PORT MIN VALUE || minPort > PORT MAX VALUE) 
throw new ArgumentOutOfRangeException( 
$"Min port cannot be less than (PORT MIN VALUE] " + 
$"or greater than [PORT MAX VALUE"); 
if (maxPort « PORT MIN VALUE || maxPort » PORT MAX VALUE) 
throw new ArgumentOutOfRangeException( 
$"Max port cannot be less than (PORT MIN VALUE] " + 
$"or greater than (PORT MAX VALUE]"); 


this.Host - host; 
this.MinPort - minPort; 
this.MaxPort - maxPort; 
SetupLists(); 

} 


private void SetupLists() 


{ 











// 将 列表 容量 设置 为 范围 的 一 半 大 小 
// 因为 我 们 并 不 能 知道 有 多 少 端口 是 打开 
// 所 以 折 中 分 配 足够 一 半 的 容量 





T 


的 











// rangeCount 为 max - min + 1 
int rangeCount = (this.MaxPort - this.MinPort) + 1; 
// 如 果 结 果 为 奇数 ,增加 一 个 额外 的 位 置 
if (rangeCount % 2 != 0) 
rangeCount += 1; 
// 为 范围 内 的 端口 保留 一 半空 间 
_openPorts = new List<int>(rangeCount / 2); 
_closedPorts = new List<int>(rangeCount / 2); 











} 
#endregion // CTORs & Init code 


#region Progress Result 
public class PortScanResult 


{ 


public int PortNum { get; set; } 


public bool IsPortOpen { get; set; } 
} 


#endregion // Progress Result 


#region Private Methods 
private async Task CheckPortAsync(int port, IProgress<PortScanResult> progress) 


{ 
if (await IsPortOpenAsync(port)) 



































{ 

// 如 果 代码 执行 至 此 ,说 明 端 口 是 打 开 的 

_openPorts.Add(port); 

// 通知 关注 事件 的 任何 人 

progress?.Report( 

new PortScanResult() { PortNum = port, IsPortOpen = true }); 

} 
else 
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// 服务 器 并 没有 打开 该 端口 
_closedPorts.Add(port); 
progress?.Report( 

new PortScanResult() { PortNum = port, IsPortOpen = false }); 





























} 
} 
private async Task<bool> IsPortOpenAsync(int port) 
{ 
Socket sock = null; 
try 
jl 
// 创建 一 个 基于 TCP 的 套 接 字 
sock = new Socket(AddressFamily.InterNetwork, 
SocketType.Stream, 
ProtocolType.Tcp); 
/] 连接 
await Task.Run(() => sock.Connect(this.Host, port)); 
return true; 
} 
catch (SocketException se) 
{ 
if (se.SocketErrorCode == SocketError.ConnectionRefused) 
return false; 
else 
{ 
// 试图 访问 套 接 字 时 发 生 了 一 个 错误 
Debug.WriteLine(se.ToString()); 
Console.WriteLine(se.ToString()); 
} 
} 
finally 
{ 
if (sock?.Connected ?? false) 
sock?.Disconnect(false) ; 
sock?.Close(); 
} 
return false; 
} 
#endregion 


CheapoPortScanner 的 触发 方法 是 ScanAsync, ScanAsync 将 检查 所 有 处 于 构造 函数 中 指定 
范围 内 的 端口 。LastPortScanSummary 方法 会 将 最 近 一 次 扫描 的 相关 信息 转 储 到 控制 台 输 昌 
流 ， 代 码 如 下 所 示 。 

#region Public Methods 


public async Task ScanAsync(IProgress<PortScanResult> progress) 


{ 








co 


for (int port = this.MinPort; port <= this.MaxPort; porte) 
await CheckPortAsync(port, progress); 


} 


public void LastPortScanSummary() 
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} 


Console.WriteLine($"Port Scan for host at {this.Host}"); 
Console.WriteLine($"\tStarting Port: {this.MinPort}"); 
Console.WriteLine($"\tEnding Port: {this.MaxPort}"); 


Console.WriteLine($"\tOpen ports: {string.Join(",", _openPorts)}"); 


Console.WriteLine($"\tClosed ports: {string.Join(",", _closedPorts)}"); 


} 


#endregion // Public Methods 





TestPortScanner 方法 通过 扫描 本 地 机 器 上 的 75~85 端 口 来 展示 了 如 何 使 用 


CheapoPortScanner, 一 个 Progress<CheapoPortScanner .PortScanResult> 报告 器 被 创建 者 
匿名 函数 订阅 其 ProgressChanged 事件 以 报告 扫描 的 进展 。 然 后 ，TestPortScan 


使 用 一 个 








使 用 创建 的 Progress<T> 来 调用 ScanAsync 方法 ， 以 在 扫描 器 工作 时 得 到 进度 报告 。 


调用 LastPortScanSummary 显示 扫描 的 完整 结果 ， 其 中 包含 关闭 的 端口 以 及 打开 的 端 


publ 
{ 


} 





ic static async Task TestPortScanner() 


// 进行 特定 范围 的 扫 # 
Console.WriteLine("Checking ports 75-85 on localhost..."); 
CheapoPortScanner cps = 

new CheapoPortScanner("127.0.0.1", 75, 85); 
var progress = new Progress<CheapoPortScanner .PortScanResult>(); 
progress.ProgressChanged += (sender, args) => 














Ei 











{ 
Console.WriteLine( 
$"Port {args.PortNum} is " + 
$"{args.IsPortOpen ? "open" : "closed"}"); 
a 


await cps.ScanAsync(progress); 
cps.LastPortScanSummary(); 











// 进行 本 地 机 器 扫描 ,包含 整个 端口 范围 1~65 535 
//cps = new CheapoPortScanner(); 

//await cps.Scan(progress); 
//cps.LastPortScanSummary(); 


























端口 扫描 器 的 输出 如 下 所 示 。 


Chec 
Port 
Port 
Port 
Port 
Port 
Port 
Port 
Port 
Port 
Port 
Port 
Port 


king ports 75-85 on localhost... 
75 is closed 

76 is closed 

77 is closed 

78 is closed 

79 is closed 

80 is open 

81 is closed 

82 is closed 

83 is closed 

84 is closed 

85 is closed 

Scan for host at 127.0.0.1 


m 





最 后 ， 
口 。 
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Starting Port: 75 

Ending Port: 85 

Open ports: 80 

Closed ports: 75,76,77,78,79,81,82,83,84,85 


9.16.3 讨论 

一 台 机 器 上 打开 的 端口 是 值得 注意 的 ， 因 为 它们 表明 有 程序 在 侦 听 那些 端口 。 墨 客 通过 查 
找 “ 打 开 的 ”端口 以 作为 无 需 授权 进入 你 的 系统 的 方法 。CheapoPortScanner 无 可 否认 是 一 
种 不 完善 的 用 于 检查 打开 端口 的 机 制 ， 但 它 很 好 地 展示 了 原理 以 提供 一 个 好 的 起 点 。 








如 果 你 在 一 个 公司 网 络 中 运行 它 ， 那 么 也 许 会 很 快 被 网 络 管理 员 询问 ， 因 为 
你 很 可 能 引发 了 一 些 入 侵 检 测 系统 中 的 警报 。 请 审慎 使 用 这 些 代码 。 








9.16.4 参考 
MSDN 文档 中 的 “Socket 类 ”和 “Sockets” 主 题 。 


9.17 使 用 当前 的 互联 网 连接 设置 


9.17.1 问题 

你 希望 在 程序 中 使 用 系统 当前 的 互联 网 连接 设置 ， 而 无 需 强 制 用 户 手动 在 应 用 程序 中 添加 
它们 。 

9.17.2 ”解决 方案 


使 用 例 9-10 中 为 你 提供 的 InternetSettingsReader 类 读 取 当前 互联 网 连接 设置 。 
InternetSettingsReader 通过 P/Invoke 调用 一 些 WinINet API 的 方法 ， 以 获取 当前 互联 网 
连接 信息 。 





P/Invoke (平台 调用 ) 是 NET Framework 中 为 执行 本 地 调用 到 非 托 管 (不 
运行 在 .NET CLR 中 ) 代码 的 机 制 。 当 你 使 用 P/Invoke 时 ， 托 管 和 非 托管 
代码 之 间 传 递 的 数据 需要 跨越 边界 进行 封 送 。 封 送 是 执行 不 同 层 间 的 调用 
并 将 参数 和 返回 数据 从 托管 到 非 托 管 进行 转换 ， 然 后 再 次 转换 回 托管 的 过 
程 。 结 构 通常 用 于 传输 数据 集 ， 因 为 它们 是 栈 上 的 值 类 型 并 且 可 用 作 输 入 / 
输出 参数 来 传输 数据 ， 而 类 是 存在 于 堆 上 的 引用 类 型 ， 并 且 通 常 仅 能 用 于 
输入 参数 。 






























































主要 工作 在 于 建立 WinINet 使 用 的 结构 并 正确 地 封 送 结构 指针 以 获取 值 。 





例 9-10; InternetSettingsReader 类 
public class InternetSettingsReader 


{ 
#region Private Members 
string _proxyAddr; 
int _proxyPort = -1; 
bool bypassLocal; 
string autoConfigAddr; 
List<string> _proxyExceptions; 
PerConnFlags _flags; 
#endregion 


#region CTOR 
public InternetSettingsReader () 


{ 
} 


#endregion 
例 9-11 中 所 示 的 InternetSettingsReader 的 每 个 属性 都 调用 了 GetInternetConnectionOption 
方法 ， 它 返回 一 个 InternetConnectionOption, InternetConnectionOption 结构 挂 有 所 有 与 
要 返回 的 值 相关 的 数据 ， 而 该 值 则 根据 指定 属性 所 要 求 的 类 型 来 获取 。 
例 9-11; InternetSettingsReader 属性 


#region Properties 
public string ProxyAddress 





























{ 
get 
{ 
InternetConnectionOption ico = 
GetInternetConnectionOption( 
PerConnOption.INTERNET. PER CONN PROXY. SERVER) ; 
// 解析 地 址 和 端口 
string proxyInfo = Marshal.PtrToStringUni( 
ico.m Value.m StringPtr); 
ParseProxyInfo(proxyInfo); 
return proxyAddr; 
} 
} 
public int ProxyPort 
{ 
get 
{ 
InternetConnectionOption ico = 
GetInternetConnectionOption( 
PerConnOption.INTERNET PER CONN PROXY SERVER); 
// 解析 地 址 和 端口 
string proxyInfo = Marshal.PtrToStringUni( 
ico.m Value.m StringPtr); 
ParseProxyInfo(proxyInfo); 
return proxyPort; 
} 
} 
public bool BypassLocalAddresses 
{ 
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j 


get 


j 


InternetConnectionOption ico - 
GetInternetConnectionOption( 
PerConnOption.INTERNET. PER CONN PROXY. BYPASS) ; 
// bypass 在 例外 列表 中 以 <LocaL> 列 出 
string exceptions = 
Marshal. PtrToStringUni(ico.m_Value.m_StringPtr); 








if (exceptions.Index0f("<local>") != -1) 
_bypassLocal = true; 

else 
_bypassLocal = false; 

return _bypassLocal; 


public string AutoConfigurationAddress 


{ 


j 


get 
{ 


j 


InternetConnectionOption ico - 
GetInternetConnectionOption( 
PerConnOption.INTERNET PER CONN AUTOCONFIG URL); 
// 直接 获取 
_autoConfigAddr = 
Marshal. PtrToStringUni(ico.m_Value.m_StringPtr); 
if (_autoConfigAddr == null) 
 autoConfigAddr = ""; 
return _autoConfigAddr; 























public IList<string> ProxyExceptions 


{ 


j 


get 
{ 


j 


InternetConnectionOption ico - 
GetInternetConnectionOption( 
PerConnOption.INTERNET. PER CONN PROXY. BYPASS) ; 
// 例外 以 分 号 来 分 隔 
string exceptions = 
Marshal. PtrToStringUni(ico.m_Value.m_StringPtr); 
if (!string.IsNullOrEmpty(exceptions)) 
{ 


j 


return _proxyExceptions; 


_proxyExceptions = new List<string>(exceptions.Split(';')); 


public PerConnFlags ConnectionType 


{ 


get 
{ 


InternetConnectionOption ico = 
GetInternetConnectionOption( 
PerConnOption.INTERNET PER CONN FLAGS); 





} 


_flags = (PerConnFlags)ico.m_Value.m_Int; 


return _flags; 


#endregion 


#region Private Methods 
private void ParseProxyInfo(string proxyInfo) 


{ 


if (!string.IsNullOrEmpty(proxyInfo) ) 


{ 


} 


string[] parts = proxyInfo.Split(':'); 
if (parts.Length == 2) 





{ 
_proxyAddr = parts[0]; 
try 
{ 
_proxyPort = Convert.ToInt32(parts[1]); 
} 
catch (FormatException) 
// 没有 端口 
_proxyPort = -1; 
} 
} 
else 
{ 
_proxyAddr = parts[0]; 
_proxyPort = -1; 
} 


例 9-12 所 zx 的 GetInternetConnectionOption 方法 承担 了 与 WMnINet 通 信 
分 工作。 首先 ， 创 建 一 个 InternetPerConnOptionList 和 一 个 用 于 保存 返回 值 的 
InternetConnectionOption 结构 。 然 后 InternetConnectionOption 结构 被 固定 ， 使 得 垃圾 
回收 器 不 会 在 内 存 中 移动 结构 ， 并 且 对 PerConnOption 赋值 以 确定 获取 哪个 互联 网 选项 。 
Marshal.SizeOf 用 于 确定 非 托 管内 存 中 两 个 托管 结构 的 大 小 。 这 些 值 被 用 于 初始 化 结构 的 
大 小 ， 这 人 允许 操作 系统 确定 处 理 的 非 托管 结构 的 版 本 。 


InternetPerConnOptionList 被 初始 化 以 保存 选项 值 ， 
InternetQueryOption, InternetConnectionOption 类 可 使 用 MarshaL.PtrToSstructure 方法 


填充 ， 它 将 来 自 非 托管 代码 的 包含 InternetConnection0ption 数据 的 非 托 管 结构 中 的 值 映 



































射 到 托管 对 象 实例 ， 然 后 使 用 该 值 返 回 托管 版 本 。 





例 9-12: GetInternetConnectionOption 方法 


private static InternetConnectionOption GetInternetConnectionOption( 
PerConnOption pco) 


// 分 配 List 和 option 























的 大 部 


然 后 调 JH WinInet 函数 
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Internet 
Internet 
// 固 定 op 
GCHandle 
// 用 我 们 
ico.m_Op 
// 将 opti 
int list 
perConn0 
perConn0 
perConn0 
perConn0 


PerConnOptionList perConnOptList = new InternetPerConnOptionList(); 
ConnectionOption ico = new InternetConnectionOption(); 
tion 结 构 

gch = GCHandle.Alloc(ico, GCHandleType.Pinned); 

想 要 的 数据 初始 化 option 

tion = pco; 

on list 初 始 化 为 默认 连接 或 LAN 

Size = Marshal.SizeOf(perConnOptList) ; 

ptList.dwSize = listSize; 

ptList.szConnection = IntPtr.Zero; 
ptList.dwOptionCount = 1; 

ptList.dwOptionError = 0; 


// 确定 大 小 和 偏 移 值 


int icoS 
// 为 opt 
perConnO 

Mars 


ize - Marshal.SizeOf(ico); 


ion 分 配 足 够 内 存 ( 本 地 内 存 , 非 .NET 堆 ) 
ptList.options = 
hal.AllocCoTaskMem(icoSize); 


// 从 结构 体 中 创建 指针 





IntPtr o 
Marshal. 
OEA 
if (Nati 
IntP 
755 
ref 
ref 
t 
/ [3X 
ico 


ptionListPtr = perConnOptList.options; 
StructureToPtr(ico, optionListPtr, false); 


ify 

veMethods.InternetQueryOption( 

tr.Zero, 

//(Ant)InternetOption.INTERNET OPTION PER CONNECTION OPTION, 
perConnOptList, 

listSize) -- true) 

取 值 


(InternetConnectionOption)Marshal.PtrToStructure( 
perConnOptList.options, 
typeof(InternetConnectionOption)); 


OM 内 存 


FreeCoTaskMem(perConnOptList.options); 
构 的 固定 
Qs 





co; 


Reader 的 使 用 通过 例 9-13 中 所 示 的 GetInternetSettings 方法 进行 演 





























信息 并 显示 到 控制 台 ， 但 该 信息 可 很 容易 存储 在 其 他 程序 中 ， 以 在 连接 





} 
// 释放 C 
Marshal. 
// 解 除 结 
gch.Free 
return i 
} 
#endregion 
} 
InternetSettings 
示 。 此 处 获取 代 弄 
时 用 作 代 理 信息 。 
93 市 )。 


例 9-13: 使 用 In 


有 关 为 一 个 WebRequest 设置 代理 信息 的 详细 内 容 ， 请 参考 范例 9.3 (B 


ternetSettingsReader 


public static void GetInternetSettings() 


Console.WriteLine(""); 
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} 


Console.WriteLine("Reading current internet connection settings"); 
InternetSettingsReader isr - new InternetSettingsReader(); 
Console.WriteLine($"Current Proxy Address: {isr.ProxyAddress}"); 
Console.WriteLine($"Current Proxy Port: {isr.ProxyPort}"); 
Console.WriteLine($"Current ByPass Local Address setting: " + 
$"((isr.BypassLocalAddresses]"); 
Console.WriteLine("Exception addresses for proxy (bypass):"); 
string exceptions; 
if (isr.ProxyExceptions?.Count » 0) 
exceptions = "At" + (string.Join(",", isr.ProxyExceptions?.ToArray())); 
else 
exceptions = "\tNone"; 
Console.WriteLine($"Proxy connection type: {isr.ConnectionType. ToString()}"); 
Console.WriteLine(""); 


解决 方案 的 输出 如 下 所 示 。 


Reading current internet connection settings 
Current Proxy Address: http=127.0.0.1 
Current Proxy Port: -1 

Current ByPass Local Address setting: False 
Exception addresses for proxy (bypass): 


<- lLoopback> 


Proxy connection type: PROXY_TYPE_DIRECT 


9.17.3 


讨论 


WinInet Windows Internet (WinInet) API 是 用 于 与 FTP、HTTP 和 Gopher 协议 进行 交互 的 
非 托 管 API。 该 API 可 用 于 提供 托管 代码 尚未 提供 的 功能 ， 例 如 9.17.2 闻 所 示 的 互联 网 配 
置 设置 。 它 还 用 于 下 载 文件 、 使 用 Cookie 以 及 参与 Gopher 会 话 。 要 记 住 WinInet 是 一 个 
客户 端的 API， 它 不 适用 于 服务 器 端 或 服务 应 用 程序 ， 不 正确 的 使 用 会 引发 应 用 程序 中 的 


问题 o 




















直接 通过 BCL (基础 类 库 ) 可 为 C# 程序 员 提供 大 量 可 用 的 信息 ， 但 有 时 仍然 需要 迎 难 
而 上 地 与 Win32 API 对 话 。 即 使 是 在 有 限 特权 为 规范 的 情况 下 ， 创 建 一 个 需要 增强 访问 
以 进行 P/Invoke 的 小 程序 集 也 常常 是 合理 的 。 它 可 能 会 被 锁定 访问 ， 以 避免 成 为 对 系 
统 的 风险 。 我 们 在 范例 11.6 (BN 11.6 节 ) 中 展示 了 如 何 限制 一 个 程序 集 ， 你 需要 使 用 


SecurityPermissionFlag.UnmanagedCode 来 断言 SecurityPermission, 

















9174 参考 


MSDN 文档 中 的 “InternetQueryOption function [WinInet]”“ 与 非 托 管 代码 交互 操作 ”和 
“Using P/Invoke to Call Unmanaged APIs from Your Managed Classes” 主 题 。 
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9.18 使 用 FTP 传 输 文件 


9.18.1 
你 希望 以 编程 方式 使 用 文件 传输 协议 (FTP) 下 载 和 上 传 文件 。 


9.18.2 ”解决 方案 


使 月 





问题 





H System.Net.FtpWebRequest 类 执行 这 些 操 作 。FtpWebRequest 可 通过 指定 FTP 下 载 


URI 从 WebRequest 类 的 Create 方法 生成 。 在 下 面 的 示例 中 ， 以 来 自 C# Cookbook 最 新 版 
的 源 代 码 作为 下 载 的 目标 。 针 对 目标 文件 打开 一 个 FiLeStream， 然 后 由 一 个 BinaryWriter 
封装 。BinaryReader 使 用 来 自 FtpWebRequest 的 响应 流 进行 创建 。 然 后 读 取 流 并 写 入 目标 
F 直 到 整个 文件 下 载 完成 。 这 一 系列 操作 在 例 9-14 中 的 FtpDownloadAsync 方法 中 展示 。 





xfi 











例 9-14. 使 用 System.Net.FtpWebRequest 类 
public static async Task FtpDownloadAsync(Uri ftpSite, string targetPath) 


{ 


try 
{ 


FtpWebRequest request = 
(FtpWebRequest)WebRequest.Create( 
ftpSite); 


request.Credentials = new NetworkCredential("anonymous", 
"authorsQoreilly.com"); 

using (FtpWebResponse response = 
(FtpWebResponse)await request.GetResponseAsync()) 


{ 
Stream data = response.GetResponseStream(); 
File.Delete(targetPath); 
Console.WriteLine( 
$"Downloading {ftpSite.AbsoluteUri} to {targetPath}..."); 
byte[] byteBuffer - new byte[4096]; 
using (FileStream output - new FileStream(targetPath, FileMode.CreateNew, 
FileAccess.ReadWrite,FileShare.ReadWrite, 4096, useAsync: true)) 
{ 
int bytesRead = 0; 
do 
{ 
bytesRead = await data.ReadAsync(byteBuffer, 0, 
byteBuffer.Length); 
if (bytesRead » 0) 
await output.WriteAsync(byteBuffer, 0, bytesRead); 
} 
while (bytesRead > 0); 
} 
Console.WriteLine($"Downloaded {ftpSite.AbsoluteUri} to {targetPath}"); 
} 
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catch (WebException e) 


{ 
Console.WriteLine( 
S"Failed to download {ftpSite.AbsoluteUri} to {targetPath}"); 
Console.WriteLine(e); 
} 


} 
以 下 是 调用 FtpDownloadAsync 的 一 个 示例 。 


Uri downloadFtpSite = 

new Uri("ftp://ftp.oreilly.com/pub/examples/csharpckbk/CSharpCookbook. zip"); 
string targetPath - "CSharpCookbook.zip"; 
await NetworkingAndWeb.FtpDownloadAsync(downloadFtpSite, targetPath); 


要 上 传 一 个 文件 ， 可 使 用 FtpWebRequest 以 使 用 GetRequestStream 获得 请 求 上 的 一 个 流 ， 
并 使 用 它 上 传 文件 。 一 旦 文件 被 打开 并 写 入 请 求 流 ， 就 可 以 通过 调用 GetResponse 执行 请 
求 并 检查 StatusDescription 属性 以 获得 操作 的 结果 。 这 展示 在 如 下 的 FtpUploadAsync 7j 
法 中 。 


public static async Task FtpUploadAsync(Uri ftpSite, string uploadFile) 
{ 


T 








Console.WriteLine($"Uploading {uploadFile} to {ftpSite.AbsoluteUri}..."); 
try 
{ 
FileInfo fileInfo = new FileInfo(uploadFile) ; 
FtpWebRequest request = 
(FtpWebRequest )WebRequest.Create( 
ftpSite); 
request.Method - WebRequestMethods.Ftp.UploadFile; 
// 如 果 用 于 文本 文件 并 需要 跨 操作 系统 平台 
// 你 也 许 会 想 将 此 值 设置 为 faLse, 以 避免 行 结束 符 问 题 
request.UseBinary = true; 
request.ContentLength = fileInfo.Length; 
request.Credentials = new NetworkCredential("anonymous", 
"authorsQoreilly.com"); 
byte[] byteBuffer - new byte[4096]; 
using (Stream requestStream - await request.GetRequestStreamAsync()) 


( 





using (FileStream fileStream - 
new FileStream(uploadFile, FileMode.Open, FileAccess.Read, 
FileShare.Read, 4096, useAsync: true)) 


int bytesRead 
do 


( 


0; 


bytesRead = await fileStream.ReadAsync(byteBuffer, 0, 
byteBuffer.Length); 
if (bytesRead » 0) 
await requestStream.WriteAsync(byteBuffer, 0, bytesRead); 


} 
while (bytesRead > 0); 
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using (FtpWebResponse response = 
(FtpWebResponse) await request.GetResponseAsync()) 


{ 
Console.WriteLine(response.StatusDescription) ; 

} 

Console.WriteLine($"Uploaded {uploadFile} to {ftpSite.AbsoluteUri}... 
} 
catch (WebException e) 
{ 

Console.WriteLine( 

S"Failed to upload {uploadFile} to {ftpSite.AbsoluteUri}."); 
Console.WriteLine(((FtpWebResponse)e.Response).StatusDescription); 
Console.WriteLine(e); 

} 


以 下 是 调用 FtpUploadAsync 方法 的 一 个 示例 。 


string uploadFile = "SampleClassLibrary.dll"; 
Uri uploadFtpSite = 


new Uri($"ftp://localhost/{uploadFile}"); 


await NetworkingAndWeb.FtpUploadAsync(uploadFtpSite, uploadFile); 


9.18.3 讨论 


文件 传输 协议 (FTP) 在 RFC 959 PEX, EA 








"3 


E 互 联网 上 分 发 文件 的 主要 方式 。 用 于 FTP 


的 端口 号 是 21。 幸 运 的 是 ， 你 不 必 为 了 使 用 FTP 而 真正 了 解 很 多 FTP 如 何 工作 的 信息 。 
这 会 有 助 于 应 用 程序 自动 下 载 来 自 专用 FTP 站 点 的 信息 或 者 提供 自动 上 传 功能 。 


9.184 参考 


MSDN x 档 中 的 “FtpWebRequest 类 ” “FtpWebResponse 类 " “WebRequest 类 ”和 
"WebResponse 类 ”主题 。 
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XML 





10.0 简介 


可 扩展 标记 语言 (extensible markup language, XML) 是 一 种 以 结构 化 格式 表示 数据 的 简 
单 、 灵 活 、 可 移植 的 方法 。XML 可 用 于 许多 方面 ， 既 可 充当 基于 Web 的 消息 协议 的 基 
础 (例如 SOAP)， 也 能 作为 一 种 存储 配置 数据 的 流行 方法 (例如 .NET Framework 中 的 
web.config, machine.config 或 security.config X tF). Microsoft 认识 到 了 XML 对 开发 人 员 
的 用 处 ， 并 且 在 给 开发 人 员 取 舍 选 择 方面 做 了 展 好 的 工作 。 有 时 候 你 希望 以 类 似 只 读 游标 
的 方式 简单 地 在 XML 文档 中 查找 某 个 值 ， 有 些 时 候 ， 你 需要 能 够 随机 访问 文档 的 各 个 部 
分 ; 还 有 些 时 候 ， 能 够 以 声明 方式 查询 并 处 理 XML 是 很 方便 的 。Microsoft 提供 了 诸如 用 
于 轻型 访问 的 XmlReader 和 xmtnriter 类 以 及 用 于 完整 文档 对 象 模式 (DOM) 处 理 支持 的 
XmlDocument 类 。 为 了 支持 以 声明 方式 查询 XML 文档 或 者 构建 XML，C# 以 XELement 和 
XDocument 类 的 形式 提供 了 LINQ to XML (也 被 称 为 XLINQ)。 


你 可 能 或 多 或 少 会 在 NET 中 处 理 XML。 本 章 探 索 了 XML 和 基于 XML 的 技术 (例如 
XPath 和 XSLT) 有 何 作 用 ， 并 且 展 示 了 如 何 通 过 LINQ to XML 来 使 用 或 者 在 其 些 时 候 代 
赫 这 些 技术 。 本 章 探 讨 的 主题 还 包括 XML 验证 和 从 XML 到 HTML 的 转换 。 


10.1 以 文档 顺序 读 取 和 访问 XML 数据 


10.1.1 问题 


你 需要 读 取 一 个 XML 文档 中 的 所 有 元 素 并 获得 关于 每 个 元 素 的 信息 ， 例 如 它 的 名 称 和 
属性 。 
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10.1.2 ”解决 方案 
创建 一 个 xmLReader 并 使 用 它 的 Read 方法 去 处 理 文档 ， 如 例 10-1 所 示 。 
例 10-1: 读 取 一 个 XML 文档 


public static void AccessXml() 


























// 构建 XML 的 新 LINQ to XML 语法 
XDocument xDoc = new XDocument( 
new XDeclaration("1.0", "UTF-8", "yes"), 
new XComment("My sample XML"), 
new XProcessingInstruction("myProcessingInstruction", 
"value"), 
new XElement("Root", 
new XElement("Node1", 
new XAttribute("nodeId", "1"), "FirstNode"), 
new XElement("Node2", 
new XAttribute("nodeId", "2"), "SecondNode"), 
new XElement("Node3", 
new XAttribute("nodeId", "1"), "ThirdNode") 
) 
)3 


// 将 XML 输出 到 控制 台 


Console.WriteLine(xDoc.ToString()); 





// 从 XDocument 中 创建 一 个 XmlReader 
XmlReader reader = xDoc.CreateReader(); 
reader .Settings.CheckCharacters = true; 
int level = 0; 
while (reader .Read()) 
{ 
switch (reader .NodeType) 
{ 
case XmlNodeType.CDATA: 
Display(level, $"CDATA: {reader.Value}"); 
break; 
case XmlNodeType.Comment: 
Display(level, S"COMMENT: {reader.Value}"); 
break; 
case XmlNodeType.DocumentType: 
Display(level, $"DOCTYPE: {reader .Name}={reader .Value}"); 
break; 
case XmlNodeType.Element: 
Display(level, S"ELEMENT: {reader .Name}"); 
level++; 
while (reader .MoveToNextAttribute() ) 


{ 
} 


break; 

case XmlNodeType.EndElement: 
level--; 
break; 


Display(level, S"ATTRIBUTE: {reader .Name}='{reader.VaLlue}'"); 





case XmlNodeType.EntityReference: 
Display(level, S"ENTITY: (reader.Name]", reader.Name); 
break; 
case XmlNodeType.ProcessingInstruction: 
Display(level, S"INSTRUCTION: (reader.Namej-[reader.Value]"); 
break; 
case XmlNodeType.Text: 
Display(level, $"TEXT: {reader.Value}"); 
break; 
case XmlNodeType.XmlDeclaration: 
Display(level, $"DECLARATION: {reader .Name}={reader .Value}"); 
break; 


} 


private static void Display(int indentLevel, string format, params object[] args) 
{ 
for (int i = 0; i < indentLevel; i++) 
Console.Write(" "); 
Console.WriteLine(format, args); 


} 
下 面 的 代码 以 层次 格式 转 储 XML 文档 。 


<!--My sample XML--> 
«?myProcessingInstruction value?» 
«Root» 

<Node1 nodeId="1">FirstNode</Node1> 

«Node2 nodeId="2">SecondNode</Node2> 

<Node3 nodeId="1">ThirdNode</Node3> 
</Root> 
COMMENT: My sample XML 
INSTRUCTION: myProcessingInstruction-value 
ELEMENT: Root 

ELEMENT: Node1 

ATTRIBUTE: nodeId='1' 

TEXT: FirstNode 

ELEMENT: Node2 

ATTRIBUTE: nodeId='2' 

TEXT: SecondNode 

ELEMENT: Node3 

ATTRIBUTE: nodeId='1' 

TEXT: ThirdNode 














10.1.3 讨论 


读 取 已 有 的 XML 并 识别 不 同 的 节点 类 型 是 开发 人 员 在 处 理 XML 时 需要 执行 的 基础 行为 。 
解决 方案 中 的 代码 从 一 个 声明 式 的 结构 化 XML 文档 中 创建 了 一 个 xmLReader ， 然 后 在 节点 
上 迭代 时 重新 创建 格式 化 的 XML 以 便 向 控制 台 窗 口 输出 。 


10.1.2 节 展 示 了 如 何 通过 使 用 一 个 XDocument 创建 一 个 XML 文档 ， 并 使 用 诸如 XELement、 
XAttribute 和 XComment 之 类 的 各 种 LINQ to XML 类 构成 内 联 XML, 
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XDocument xDoc = new XDocument( 
new XDeclaration("1.0", "UTF-8", "yes"), 
new XComment("My sample XML"), 
new XProcessingInstruction("myProcessingInstruction", 
"value"), 
new XElement("Root", 
new XElement("Node1", 
new XAttribute("nodeId", "1"), "FirstNode"), 
new XElement("Node2", 
new XAttribute("nodeId", "2"), "SecondNode"), 
new XElement("Node3", 
new XAttribute("nodeId", "1"), "ThirdNode") 
) 
)3 


建立 XDocument 之 后 ， 你 需要 对 XmlReader 进行 设置 ， 这 些 设 置 位 于 通过 XmlReader. 
Settings 属性 访问 的 一 个 XmlReaderSettings 对 象 。 这 些 设置 告诉 XmlReader 检查 XML Hr 
段 中 的 任意 非法 字符 。 

// 从 XDocument 中 创建 一 个 XmlReader 


XmlReader reader = xDoc.CreateReader(); 
reader.Settings.CheckCharacters = true; 


while 循环 通过 每 次 读 取 一 个 市 点 并 检查 读 取 器 当前 市 点 的 NodeType 属性 在 XML 上 进行 
迭代 ， 以 确定 XML 节点 所 属 的 类 型 。 


while (reader.Read()) 
{ 














switch (reader .NodeType) 
{ 


NodeType 属性 是 一 个 XmlNodeType 枚 举 值 ， 指 定 了 可 能 存在 的 XML 节点 类 型 。 
XmLNodeType 枚 举 值 如 表 10-1 所 示 。 


表 10-1: xmLNodeType 枚 举 值 

































































名 称 JH 述 

Attribute 一 个 元 素 的 属性 节点 

CDATA 一 个 标记 ， 用 于 要 转 义 的 、 通 第 被 视 作 标记 的 文本 段 
Comment XML 中 的 注释 : «!-- my comment --> 

Document XML 文档 树 的 根 

DocumentFragment 文档 片段 节点 

DocumentType 文档 类 型 声明 

ELement 一 个 元 素 标 签 : <myelement> 

EndElement 一 个 结束 元 素 标签 : </myelement> 

EndEntity 调用 ResolveEntity 之 后 在 实体 末尾 返回 

Entity 实体 声明 

EntityReference 一 个 对 实体 的 引用 

None 如 果 XmlReader 上 的 Read 尚未 被 调用 则 返回 这 个 市 点 
Notation DTD (文档 类 型 定义 ) 中 的 一 个 符号 
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A B 





ProcessingInstruction 
SignificantWhitespace 
Text 

Whitespace 


XmlDeclaration 


10.1.4 参考 


处 理 指令 : «?pi myProcessingInstruction?> 

















当 使 用 混合 内 容 模式 或 者 空白 被 保留 时 的 空白 




















节点 的 文本 内 容 


标记 实体 之 间 的 空白 





文档 中 第 一 个 节点 ， 不 能 拥有 子 节点 ，<?xmt version="1.0'2> 





MSDN 文档 中 的 “XmlReader 类 ”“XmlNodeType 枚 举 ” 和 “XDocument 类 ”主题 。 


10.2 ”查询 XML 文档 的 内 容 





10.2.1 问题 





你 有 一 个 很 大 并 且 很 复杂 








的 XML 文档 ， 需 要 从 中 找 出 各 种 各 样 的 信息 ， 例 如 某 一 特定 元 








素 内 包含 的 具有 特定 属性 设置 的 所 有 内 容 。 你 希望 查询 XML 结构 但 不 想 在 XML 文档 的 


所 有 闻 点 上 手动 进行 迭代 讨 








10.2.2 ”解决 方案 


使 用 新 的 LINQ to XML API 来 查询 XML 文档 中 感 兴 趣 的 项 。LINQ 允许 你 根据 元 素 和 属 








搜索 某 一 特定 项 。 














性 值 选 择 元 素 ， 排 序 结果 ， 并 且 和 返回 一 个 基于 IEnumerable 的 结果 数据 集合 ， 如 例 10-2 


所 示 。 


例 10-2: 使 用 LINQ 查询 一 个 XML 文档 

private static XDocument GetAClue() => new XDocument( 
new XDeclaration("1.0", "UTF-8", "yes"), 
new XElement("Clue", 


new 
new 
new 
new 
new 
new 
new 


)5 


XElement("Participant", 

new XAttribute("type", "Perpetrator"), "Professor Plum"), 
XElement("Participant", 

new XAttribute("type", "Witness"), "Colonel Mustard"), 
XElement("Participant", 

new XAttribute("type", "Witness"), "Mrs. White"), 
XElement("Participant", 

new XAttribute("type", "Witness"), "Mrs. Peacock"), 
XElement("Participant", 

new XAttribute("type", "Witness"), "Mr. Green"), 
XElement("Participant", 

new XAttribute("type", "Witness"), "Miss Scarlet"), 
XElement("Participant", 

new XAttribute("type", "Victim"), "Mr. Boddy") 
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要 注意 ， 当 使 用 LINQ 在 GetAClue 方法 中 构建 该 XML 片段 时 ，XML 的 结构 与 代码 的 结构 


是 非常 相似 的 。 
public static void QueryXml() 
{ 


XDocument xDoc = GetAClue(); 





// 建立 查询 ,查找 已 婚 女性 参与 者 
var query = from p in xDoc.Root 
where p.Attribute(" 
p.Value.Contain 

orderby p.Value 

select p.Value; 





// 输出 查找 到 的 市 点 (本 例 中 为 Mrs 
// 因为 结果 被 排序 了 ) 


foreach (string s in query) 


{ 
} 








Console.WriteLine(s); 


} 
LINQ to XML 示例 输出 了 下 列 内 容 。 


Mrs. Peacock 
Mrs. White 























如 果 不 使 用 LINQ 来 查询 一 个 XML 文档 ， 你 还 可 以 使 用 XPath。 在 .NET 中 ， 这 





的 证 人 
.Elements("Participant") 
type").Value == "Witness" && 
s("Mrs.") 


. Peacockf[lMrs. White, 





cL 
Ed 
A 


Ik Æ RE FH System.Xml.XPath ay 4 zx fa] LA J& i& AH XPathDocument, XPathNavigator 和 
XPathNodeIterator [2E , LINQ to XML 还 支持 通过 XELement.XPathSelectElements 方法 在 


一 个 查询 使 用 XPath 来 识别 数据 项 。 


在 例 10-3 中 ， 你 要 使 用 这 些 类 从 一 个 包含 桌 游 Clue (在 北美 之 外 也 被 称 为 Cluedo) 成 员 
及 其 各 种 角色 的 XML 文档 中 选择 节点 。 你 希望 能 够 选择 作为 犯罪 证 人 的 已 婚 女性 参与 者 。 














为 此 ， 要 传递 一 个 XPath 表达 式 去 查询 该 











XML 数据 集 ， 如 例 10-3 所 示 。 


例 10-3: 使 用 XPath 查询 一 个 XML 文档 


public static void QueryXML() 
{ 


XDocument xDoc = GetAClue(); 


using (StringReader reader = new StringReader(xDoc.ToString())) 


{ 


// 使 用 StringReader 实 例 化 一 个 XPathDocument 
XPathDocument xpathDoc = new XPathDocument(reader); 





// 获得 导航 器 





XPathNavigator xpathNav = xpathDoc.CreateNavigator(); 


// 建立 查询 查找 已 婚 的 女性 参与 者 中 的 证 人 


string xpathQuery = 





"/Clue/Participant[attribute: :type='Witness'][contains(text(),'Mrs.')]"; 


XPathExpression xpathExpr = 


xpathNav.Compile(xpathQuery) ; 





// 从 已 编译 的 表达 式 中 获得 节点 集 
XPathNodeIterator xpathIter = xpathNav.Select(xpathExpr); 





// 输出 查找 到 的 节点 (本 例 中 为 Mrs. White 和 Mrs. Peacock) 
while (xpathIter.MoveNext()) 


{ 
} 





Console.WriteLine(xpathIter.Current.Value); 


} 
XPath 示例 会 输出 下 列 内 容 。 


Mrs. White 
Mrs. Peacock 





10.2.3 ”讨论 


当 使 用 LINQ 时 ， 查 询 支 持 在 C# 中 是 一 等 公民 。 与 XPath FALL, LINQ to XML 为 大 多 数 
开发 人 员 编 写 查 询 带 来 了 更 直观 的 语法 ， 因 此 是 一 种 很 受 欢迎 的 语言 新 增 功能 。 如 果 你 需 
要 应 对 的 是 可 扩展 处 理 XML 的 系统 ， 那 么 XPath 将 会 是 一 种 值得 拥有 的 有 用 工具 。 但 是 ， 
在 许多 情况 下 ， 你 知道 自己 的 要 求 ， 只 是 不 知道 XPath 的 语法 。 甚 至 对 于 那些 拥有 很 少 


SQL 经 验 的 开发 人 员 ， 在 C# 中 查询 也 会 变 得 更 加 容易 。 
本 范例 涉及 的 XML 如 下 所 示 。 


<?xml version='1.0'?> 

<Clue> 
<Participant type="Perpetrator">Professor Plum</Participant> 
<Participant type="Witness">Colonel Mustard</Participant> 
<Participant type="Witness">Mrs. White</Participant> 
<Participant type="Witness">Mrs. Peacock</Participant> 
<Participant type="Witness">Mr. Green</Participant> 
<Participant type="Witness">Miss Scarlet</Participant> 
«Participant type="Victim">Mr. Boddy</Participant> 

</Clue> 


这 个 查询 的 意思 是 “挑选 Participant 是 一 个 证 人 并 且 其 称呼 为 Mrs. 的 所 有 Participant 
元 素 ”。 
// 建立 查询 ,查找 已 婚 的 女性 参与 者 中 的 证 人 
var query = from p in xDoc.Root.Elements("Participant") 
where p.Attribute("type").Value == "Witness" && 
p.Value.Contains("Mrs.") 


orderby p.Value 
select p.Value; 


将 这 个 查询 与 使 用 XPath 语法 的 相同 查询 相 比 较 。 
// 建立 查询 ,查找 已 婚 的 女性 参与 者 中 的 证 人 


string xpathQuery = 
"[Clue/Participant[attribute::type-'Witness'][contains(text(), 'Mrs.')]"; 
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两 种 执行 查询 的 方法 都 有 价值 ， 但 要 考虑 的 问题 是 后 续 的 开发 人 员 如 何 能 够 容易 地 理解 你 
所 编写 的 代码 。 很 容易 就 会 破坏 没 能 很 好 理解 的 代码 。 


一 般 而 言 ， 理 解 SQL 的 开发 人 员 比 理解 XPath 的 多 ， 即 使 有 了 现在 可 用 的 所 
有 Web 服务 也 是 如 此 。 这 一 点 可 能 与 你 自己 的 经 历 有 所 不 同 ， 如 果 你 做 了 
大 量 跨 平台 的 工作 ， 那 么 尤其 如 此 ;但 关键 在 于 不 仅仅 将 LINQ 理解 为 另 一 
种 语法 ， 而 是 作为 一 种 令 你 的 代码 让 更 多 开发 人 员 易 于 阅读 的 方法 。 代 码 很 
少 被 某 个 人 拥有 ， 即 使 在 短期 内 也 是 如 此 。 因 此 ， 为 什么 不 让 那些 接替 你 的 
人 轻松 点 呢 ? 上 毕 竞 有 一 天 你 也 会 站 在 接替 别人 的 位 置 上 。 让 我 们 进一步 分 解 
这 两 个 查询 。 

































































LINQ 查询 使 用 了 CH 中 的 以 下 这 些 关 键 字 。 


。 var 指示 编译 器 期 望 根据 结果 集 推断 一 个 类 型 。 

。 from 也 称 为 生成 器 ， 为 查询 提供 一 个 可 进行 操作 的 数据 源 以 及 允许 访问 单个 元 素 的 范 

围 变量 。 

。 where 允许 将 一 个 布尔 条 件 应 用 于 数据 源 的 每 个 元 素 上 ， 以 确定 它 是 否 应 当 包 含 在 结果 
数据 集合 中 。 

。 orderby 根据 元 素 的 数目 和 每 个 元 素 的 升序 或 降序 指示 器 对 结果 集 进行 排序 。 针 对 排序 
的 多 个 级 别 可 指定 多 个 标准 。 

。 select 表示 所 有 条 件 求 值 后 将 被 返回 的 值 序列 。 这 也 称 为 值 的 投影 。 

这 意味 着 我 们 的 语法 可 以 归结 为 以 下 几 点 。 

e from p in xDoc.Root.Elements("Participant") 说 明 “ 获 得 所 有 位 于 Clue 根 级 节点 之 下 
AY Participant", 

e where p.Attribute("type").Value == "Witness" 说 明 “ 只 选择 带 有 名 为 type 的 属性 且 
属性 值 为 Witness 的 Participant", 

e && p.Value.Contains("Mrs.") 说 明 “ 只 选择 其 值 包含 Mrs. 的 Participant", 

e orderby p.Value 说 明 “ 按 名 称 以 升序 排序 参加 者 ”。 

e select p.Value 说 明 “ 选 择 已 满足 之 前 所 有 标准 的 Participant 元 素 的 值 ”。 


XPath 语法 执行 相同 的 功能 。 


e /Clue/Participants 说 明 “ 获 得 所 有 位 于 Clue 根 级 节点 之 下 的 Participant”。 

e Participant[attribute::type='Witness'] 说 明 “ 只 选择 带 有 名 为 type 的 属性 且 属 性 值 
2 Witness [IJ Participant", 

e Participant[contains(text(),'Mrs.')] 说 明 “ 只 选择 其 值 包含 Mrs. 的 Participant", 


将 它们 放 在 一 起 ， 你 就 可 以 在 两 种 情况 下 获得 作为 证 人 的 所 有 已 婚 女 性 参与 者 ， 并 且 使 用 
LINQ 对 结果 进行 排序 。 
















































































10.2.4 参考 


MSDN 文档 中 的 “查询 表达 式 ”“XElement 类 ”和 “XPath， 读 取 XML” 主题。 
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10.3 ”验证 XML 


10.3.1 


问题 








你 正在 接收 一 个 由 其 他 来 源 创建 的 XML 文档， 并且 和 希望 验证 它 是 否 遵循 某 一 特定 架构 。 
这 一 模式 可 以 是 XML 架构 (XSD 或 XML-XDR) 的 形式 ， 或 者 是 希望 能 灵 话 使 用 文档 类 
型 定义 (DTD) 来 验证 XML, 


10.3.2 ”解决 方案 

使 用 XDocument.Validate 方法 和 XmlReader . Settings 属性 来 验证 XML 文档 与 其 他 描述 符 
文档 (如 XSD、DTD 或 者 XDR)， 如 例 10-4 所 示 。 作 为 测试 的 一 部 分 来 验证 从 你 的 软件 
中 生成 的 XML， 将 会 使 你 从 稍 后 整合 其 他 系统 〈 或 者 系统 的 组 件 ) 时 的 bug 中 解放 出 来 ， 





并 且 强 















































烈 鼓 励 这 样 做 ! 


例 10-4: 验证 XML 
public static void ValidateXml() 


{ 








// 打开 bookbad.xml 文 件 
XDocument book = XDocument.Load(@"..\..\BookBad.xml"); 
// 使 用 book.xsd 创 建 XSD 架 构 集合 

XmlSchemaSet schemas = new XmlSchemaSet(); 
schemas.Add(null,@"..\..\Book.xsd"); 

// 装配 处 理 程序 以 获得 任意 验证 错误 通知 


book.Validate(schemas, settings ValidationEventHandler); 




















// 创建 一 个 读 取 器 以 读 取 文件 ,从 而 触发 验证 

XmlReader reader = book.CreateReader(); 

// 同时 报告 错误 和 警告 

reader .Settings.ValidationFlags = 
XmlSchemaValidationFlags.ReportValidationWarnings; 

// 使 用 XML 架构 

reader .Settings.ValidationType = ValidationType.Schema; 


// 读 取 XML 
while (reader.Read()) 
: if (reader.NodeType == XmlNodeType. Element) 
: Console.Write($"<{reader.Name}"); 
while (reader .MoveToNextAttribute()) 
f Console.Write($"{reader .Name}='{reader.Value}'"); 
ee 
am if (reader.NodeType == XmlNodeType. Text) 
i Console.Write(reader.Value); 
} 


else if (reader.NodeType == XmlNodeType.EndElement) 
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Console.WriteLine($"</{reader.Name}>"); 


j 


private static void settings ValidationEventHandler(object sender, 
ValidationEventArgs e) 


{ 


Console.WriteLine($"Validation Error Message: {e.Message}"); 
Console.WriteLine($"Validation Error Severity: {e.Severity}"); 
Console.WriteLine($"Validation Error Line Number: {e.Exception?.LineNumber}"); 
Console.WriteLine( 

$'Validation Error Line Position: {e.Exception?.LinePosition}"); 
Console.WriteLine($"Validation Error Source: {e.Exception?.Source}"); 
Console.WriteLine($"Validation Error Source Schema: " + 

S"{{e. Exception? .SourceSchemaObject}"); 

Console.WriteLine($"Validation Error Source Uri: {e.Exception?.SourceUri}"); 
Console.WriteLine($"Validation Error thrown from: {e.Exception?.TargetSite}"); 
Console.WriteLine($"Validation Error callstack: {e.Exception?.StackTrace}"); 


10.3.3 ”讨论 


10.3.2 节 举 例 说 明了 如 何 使 用 XDocument 和 XmlReader 去 验证 book.xml 文档 是 否 符合 book. 
xsd XSD 定义 文件 。DTD 是 指定 一 个 XML 文档 结构 的 最 初 方法 ， 但 是 由 于 XSD 在 2001 
年 到 达 了 W3C 推荐 状态 ， 使 用 XSD 已 经 变 得 更 加 常见 。XDR 是 由 Microsoft 提供 的 XSD 
的 前 身 。 虽 然 它 可 能 会 在 现存 系统 中 遇 到 ， 但 不 应 该 用 于 新 的 开发 。 


要 做 的 第 一 件 事 是 创建 一 个 XmlSchemaset 以 持 有 你 的 XSD 文件 (book.xsd) 并 且 调 用 Add 
方法 向 XmUSchemaSet 添加 该 XSD。 使 用 xmLSchemaset 和 用 于 验证 事件 的 处 理 程 序 方法 调 
用 XDocument 上 的 Validate 方法 。 现 在 ， 验 证 已 基本 设置 ， 更 多 的 选项 可 在 从 XDocument 
中 创建 的 XmlReader Hik E, XmlReaderSettings 上 的 VaLidationFLags 属性 允许 注册 检验 
中 的 警告 、 在 验证 过 程 中 处 理 标识 约束 、 处 理 内 联 和 架构、 以 及 允许 那些 可 能 在 模式 中 未 定 

// 使 用 book.xsd 创 建 XSD 架 构 集合 


XmlSchemaSet schemas = new XmlSchemaSet(); 
schemas .Add(null,@"..\..\Book.xsd"); 


// 装配 处 理 程序 以 获得 任意 验证 错误 通知 


book.Validate(schemas, settings ValidationEventHandler); 
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// 创建 一 个 读 取 器 以 读 取 文件 ,从 而 触发 验证 
XmlReader reader = book.CreateReader(); 
// 同时 报告 错误 和 警告 
reader.Settings.ValidationFlags = 

XmlSchemaValidationFlags.ReportValidationWarnings; 
// 使 用 XML 架构 


reader.Settings.ValidationType = ValidationType. Schema; 











要 执行 DTD 验证 ， 可 使 用 一 个 DTD 和 ValidationType.DTD， 要 执行 XDR 
验证 ， 使 用 一 个 XDR 架构 和 ValidationType.XDR, 





随后 当 一 个 验证 错误 发 生 时 ，settings_ValidationEventHandler pK Zi x dr [Am 
ValidationEventArgs 对 象 并 且 将 相关 信息 写 入 控制 台 。 


private static void settings_ValidationEventHandler(object sender, 
ValidationEventArgs e) 


{ 
Console.WriteLine($"Validation Error Message: {e.Message}"); 
Console.WriteLine($"Validation Error Severity: {e.Severity}"); 
Console.WriteLine( 
$'Validation Error Line Number: {e.Exception?.LineNumber}"); 
Console.WriteLine( 
$'Validation Error Line Position: (e.Exception?.LinePosition]"); 
Console.WriteLine($"Validation Error Source: {e.Exception?.Source}"); 
Console.WriteLine($"Validation Error Source Schema: " + 
$"{{e. Exception? .SourceSchemaObject}"); 
Console.WriteLine($"Validation Error Source Uri: {e.Exception?.SourceUri}"); 
Console.WriteLine( 
$'Validation Error thrown from: {e.Exception?.TargetSite}"); 
Console.WriteLine($"Validation Error callstack: {e.Exception?.StackTrace}"); 
} 


然后 继续 在 XML 文档 上 进行 工作 并 且 写 出 元 素 和 属性 。 
while (readerOld.Read()) 


{ 
if (readerOld.NodeType == XmlNodeType. Element) 
{ 
Console.Write($"<{readerOld.Name}"); 
while (reader .MoveToNextAttribute()) 
{ 
Console.Write($"{readerOld.Name}='{readerOld.Value}'"); 
} 
Console.Write(">"); 
} 
else if (readerOld.NodeType == XmLNodeType. Text) 
{ 
Console.Write(reader.Value); 
} 
else if (readerOld.NodeType == XmlNodeType.EndElement) 
{ 
Console.WriteLine($"</{readerOld.Name}>"); 
} 
} 


BookBad.xml 文件 包含 下 列 内 容 。 


<?xml version="1.0" encoding="utf-8"?> 
«Book xmlns="http://tempurt.org/Book.xsd" name="C# Cookbook"> 
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<Chapter>File System IO«/Chapter» 
<Chapter>Security</Chapter> 
<Chapter>Data Structures and Algorithms</Chapter> 
<Chapter>Reflection</Chapter> 
<Chapter>Threading and Synchronization</Chapter> 
<Chapter>Numbers and Enumerations</Chapter> 
<BadElement>I don't belong here</BadElement> 
<Chapter>Strings and Characters</Chapter> 
<Chapter>Classes And Structures</Chapter> 
<Chapter>Collections</Chapter> 
<Chapter>XML</Chapter> 
<Chapter>Delegates, Events, and Anonymous Methods</Chapter> 
<Chapter>Diagnostics</Chapter> 
<Chapter>Toolbox</Chapter> 
<Chapter>Unsafe Code</Chapter> 
<Chapter>Regular Expressions</Chapter> 
<Chapter>Generics</Chapter> 
<Chapter>Iterators and Partial Types</Chapter> 
<Chapter>Exception Handling</Chapter> 
<Chapter>Web</Chapter> 
<Chapter>Networking</Chapter> 

</Book> 


book.xsd 文件 包含 下 列 内 容 。 


<?xml version="1.0" ?> 
«xs:schema id="NewDataSet" targetNamespace-"http://tempuri.org/Book.xsd" 
xmlns:mstns-"http://tempuri.org/Book.xsd" 
xmlns-"http://tempuri.org/Book.xsd" 
xmlns:xsz"http: //www.w3.0rg/2001/XMLSchema" 
xmlns:msdata-"urn:schemas-microsoft-com:xml-msdata" 
attributeFormDefault-"qualified" elementFormDefauLt="qualified"> 
<xs:element name="Book"> 
<xs:complexType> 
<xs : Sequence> 
<xs:element name="Chapter" nillable="true" 
minOccurs="0" maxOccurs="unbounded"> 
«xs:complexType» 
«xs:simpleContent 
msdata:ColumnName-"Chapter Text" msdata:Ordinal="0"> 
«xs:extension base="xs:string"> 
«[xs:extension» 
</xs:simpleContent> 
</xs:complexType> 
</xs:element> 
«[xs:sequence» 
«xs:attribute name="name" form="unqualified" type="xs:string"/> 
</xs:complexType> 
</xs:element> 
</xs:schema> 


当 它 运行 时 ， 会 生成 下 列 输 出， 显示 发 生 在 BadElement 上 的 验证 失败 。 


Validation Error Message: The element 'Book' in namespace 'http://tempuri.org/Bo 
ok.xsd' has invalid child element 'BadElement' in namespace 'http://tempuri.org/ 





Book.xsd'. List of possible elements expected: 'Chapter' in namespace 'http://te 
mpuri.org/Book.xsd'. 

Validation Error Severity: Error 

Validation Error Line Number: 0 

Validation Error Line Position: 0 

Validation Error Source: 

Validation Error Source Schema: 

Validation Error Source Uri: 

Validation Error thrown from: 

Validation Error callstack: 

«Book xmlns-'http://tempuri.org/Book.xsd' name='C# Cookbook'><Chapter>File Syste 
m I0</Chapter> 

<Chapter>Security</Chapter> 

<Chapter>Data Structures and Algorithms</Chapter> 
<Chapter>Reflection</Chapter> 

<Chapter>Threading and Synchronization</Chapter> 
<Chapter>Numbers and Enumerations</Chapter> 
<BadElement>I don't belong here</BadElement> 
<Chapter>Strings and Characters</Chapter> 
<Chapter>Classes And Structures</Chapter> 
<Chapter>Collections</Chapter> 
<Chapter>XML</Chapter> 

<Chapter>Delegates, Events, and Anonymous Methods</Chapter> 
<Chapter>Diagnostics</Chapter> 
<Chapter>Toolbox</Chapter> 

<Chapter>Unsafe Code</Chapter> 

<Chapter>Regular Expressions</Chapter> 
<Chapter>Generics</Chapter> 

<Chapter>Iterators and Partial Types</Chapter> 
<Chapter>Exception Handling</Chapter> 
<Chapter>Web</Chapter> 
<Chapter>Networking</Chapter> 

</Book> 


10.34 参考 


MSDN x fü h ÉJ *XmlReader 类 " *XmlSchemaSet 类 " “ValidationType 枚 4 ” 和 
“XDocument 类 ”主题 。 


10.4 检测 对 XML 文档 的 修改 


10.4.1 问题 
你 需要 通知 一 个 或 多 个 类 或 者 组 件 : 在 XML 文档 中 已 经 插入 或 移 除了 某 个 节点 或 者 其 值 
已 改变 。 


10.4.2 ”解决 方案 


为 了 跟踪 对 一 个 活跃 的 XML 文档 的 修改 ， 订 阅 XDocument 类 发 布 的 事件 。XDocument 发 布 
了 关于 一 个 市 点 何 时 将 发 生 改变 以 及 它 何 时 发 生 了 改变 的 事件 ， 分 别 用 于 市 点 变化 的 前 置 
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和 后 置 状态 。 





例 10-5 展示 了 许多 在 与 DetectXMLChanges 方法 相同 的 作用 域 中 定义 的 事件 处 理 程序 ， 但 
它们 可 以 很 容易 作为 对 操作 在 线 XML 文档 感 兴趣 的 其 他 类 上 的 函数 进行 回调 











o 

















DetectXMLChanges 加 载 在 方法 中 定义 的 XML 片段 ， 将 事件 处 理 程 序 与 节 
加 、 修 改 并 移 除 节 点 以 触发 事件 ， 然 后 写 出 结果 XML. 
例 10-5. 检测 对 XML 文档 的 修改 


public static void DetectXmlChanges() 


{ 
































XDocument xDoc = new XDocument( 
new XDeclaration("1.0", "UTF-8", "yes"), 
new XComment("My sample XML"), 





Sy 


ma 





件 连接 ， 


new XProcessingInstruction("myProcessingInstruction", 


"value"), 
new XElement("Root", 
new XElement("Node1", 


new XAttribute("nodeId", "1"), "FirstNode"), 


new XElement("Node2", 


new XAttribute("nodeId", "2"), "SecondNode"), 


new XElement("Node3", 


new XAttribute("nodeId", "1"), "ThirdNode"), 


new XElement("Node4", 
new XCData(@"<>\&'")) 

) 

)3 
// 创建 事件 处 理 程序 
xDoc.Changing += xDoc_Changing; 
xDoc.Changed += xDoc_Changed; 
// 添加 一 个 元 素 节 点 
XElement element = new XElement("Node5", "Fifth Element"); 
xDoc.Root.Add(element); 





// 修改 第 一 个 节点 

// doc.DocumentElement.FirstChild.InnerText = "1st Node"; 

if(xDoc.Root.FirstNode.NodeType == XmlNodeType.Element) 
((XElement)xDoc.Root.FirstNode).Value = "1st Node"; 


// 移 除 第 4 个 节点 
var query = from e in xDoc.Descendants() 
where e.Name.LocalName == "Node4" 
select e; 
XElement[] elements = query. ToArray<XElement>(); 
foreach (XElement xelem in elements) 
{ 


xelem.Remove(); 


} 

// 输出 新 的 xmL 

Console.WriteLine(); 
Console.WriteLine(xDoc.ToString()); 
Console.WriteLine(); 


Ü by 








例 10-6 给 出 来 自 XDocument 的 事件 处 理 程序 以 及 格式 化 方法 WriteElementInfo, 1275051 
受 一 个 动作 字符 串 并 获得 要 操作 对 象 的 名 称 和 值 。 两 个 事件 处 理 程序 都 调用 该 格式 化 方 
法 ， 传 递 相应 的 动作 字符 串 。 


例 10-6; XDocument 事件 处 理 程序 和 WriteELementInfo 方法 
private static void xDoc_Changed(object sender, XObjectChangeEventArgs e) 


{ 




















pum 


// Add - 一 个 X0bject 已 被 或 将 要 被 添加 到 XContainer 

// Name - 一 个 X0bject 已 被 或 将 要 被 重 命名 

// Remove - 一 个 X0bject 已 被 或 将 要 被 从 XContainer 中 移 除 

// Value - X0bject 的 值 已 被 或 将 要 被 修改 ;此 外 ,一 个 空 元 素 

// (无 论 是 从 一 个 空 标记 到 开始 /结束 标记 或 者 相反 ) 的 序列 化 的 修改 
// 也 会 触发 此 事件 

WriteElementInfo("changed", e.ObjectChange, (XObject)sender); 











} 


private static void xDoc_Changing(object sender, XObjectChangeEventArgs e) 
{ 

// Add - 一 个 X0bject 已 被 或 将 要 被 添加 到 XContainer 

// Name - 一 个 X0bject 已 被 或 将 要 被 重 命名 

// Remove - 一 个 X0bject 已 被 或 将 要 被 从 XContainer 中 移 除 

// Value - Xobject 的 值 已 被 或 将 要 被 修改 ;此 外 ,一 个 空 元 素 

// (无论 是 从 一 个 空 标记 到 开始 /结束 标记 或 者 相反 ) 的 序列 化 的 修改 

// 也 会 触发 此 事件 

WriteElementInfo("changing", e.ObjectChange, (XObject)sender); 











} 


private static void WriteElementInfo(string action, XObjectChange change, 
XObject xobj) 


{ 
if (xobj != null) 
Console.WriteLine($"XObject: <{xobj.NodeType.ToString()}> "+ 
$'(action) {change} with value {xobj}"); 
else 
Console.WriteLine("XObject: <{xobj.NodeType.ToString()}> " + 
$'(action) {change} with null value"); 
} 

















DetectXMLChanges 方法 的 结果 如 下 所 示 。 


XObject: <Element> changing Add with value <Node5>Fifth ELement</Node5> 
XObject: «Element» changed Add with value <Node5>Fifth Element</Node5> 
XObject: <Text> changing Remove with value FirstNode 

XObject: <Text> changed Remove with value FirstNode 

XObject: «Text» changing Add with value 1st Node 

XObject: «Text» changed Add with value 1st Node 

XObject: «Element» changing Remove with value <Node4><! [CDATA[<>\&' ]]></Node4> 
XObject: «Element» changed Remove with value <Node4><! [CDATA[<>\&' ]]></Node4> 


<!--My sample XML--» 
«?myProcessingInstruction value?» 
«Root» 
<Node1 nodeId="1">1st Node</Node1> 
«Node2 nodeId="2">SecondNode</Node2> 
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<Node3 nodeId="1">ThirdNode</Node3> 
<Node5>Fifth Element</Node5> 
</Root> 


10.4.3 讨论 

XDocument 类 由 XElement 类 派生 而 来 。XDocument 还 可 能 包含 一 个 文档 类 型 声明 
(XDocumentType)、 一 个 根 元 素 (XDocument.Root)、 注 释 (XComment) 以 及 处 理 指 令 
(XProcessingInstruction)。 通 常 来 说 ， 你 将 会 使 用 XElement 构建 大 多 数 XML 文档 的 类 
型 ， 但 如 果 需 要 指定 上 述 项 中 的 任何 一 个 ， 请 使 用 XDocument, 























10.4.4 ”参考 


MSDN 文档 中 的 “XDocument 25" jf *XObjectChangeEventHandler 委托 ”主题 。 


10.5 处理 XML 字 符 串 中 的 无 效 字符 


10.5.1 问题 


你 正在 创建 一 个 XML 字符 串 。 在 添加 一 个 包含 文本 元 素 的 标签 之 前 ， 你 希望 检查 它 以 确 
定 字符 串 是 否 包含 下 列 非法 字符 。 


< 











> 


& 


如 果 遇 到 这 些 字符 中 的 任何 一 个 ， 你 希望 用 它们 的 转 义 形式 进行 替换 。 下 面 是 它们 的 转 义 
形式 。 

&lt; («) 

&gt; (>) 

&quot; (") 

&apos; (') 

&amp; (&) 


10.5.2 ”解决 方案 


根据 你 所 使 用 的 XML 创建 方法 ， 完 成 这 项 工作 有 多 种 不 同 的 方法 。 如 果 使 用 XELement, 
那么 使 用 XCData 对 象 或 者 直接 作为 XElenent 的 值 添 加 文本 将 会 处 理 正 确 的 转 义 。 如 果 
使 用 Xxmtlwriter， 那 么 WriteCData、WriteString、WriteAttributeString、WriteValue 和 
WriteElementString 方法 会 为 你 处 理 好 它们 。 如 果 使 用 XmlDocument 和 XmlElement, HRA 


XmLELement .InnerText 方法 将 会 处 理 这 些 字符 。 


在 使 用 XELement 处 理 非法 字符 的 第 一 种 方法 中 ，xCData 对 象 将 非法 字符 文本 封装 在 一 个 
CDATA 市 中 ， 如 后 面 示例 中 InvalidCharsi 元 素 的 生成 所 示 。 男 一 种 使 用 XELement 的 方法 
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将 文本 赋 给 





XElement 的 值 ， 并 且 自 动 转 义 文本 ， 如 创建 InvalidChars2 元 素 时 所 示 。 














// 建立 一 个 包含 非法 字符 的 字符 串 


string 


invalidChars = @"<>\&'"; 


XElement element = new XElement("Root", 
new XElement("InvalidCharsi", 
new XCData(invalidChars)), 


new XElement("InvalidChars2",invalidChars)); 


Console.WriteLine($"Generated XElement with Invalid Chars:\r\n{element}"); 
Console.WriteLine(); 


它 的 输出 如 下 所 示 。 


Generated XELement with Invalid Chars: 


<Root> 


<InvalidChars1><! [CDATA[<>\&' ]]></InvalidChars1> 
<InvalidChars2>&lt; &gt; \&amp; '</InvalidChars2> 
</Root> 





在 使 用 XmlWriter 处 型 











非法 字符 的 第 一 种 方法 中 ，writeCData 方 法 将 非法 字符 文本 封装 在 


一 个 CDATA 市 中 ， 如 后 面 示例 中 InvalidCharsi 元 素 的 生成 所 示 。 另 一 种 使 用 xmLNriter 的 


方法 使 用 WriteElementString 方法 ， 














// 建立 一 个 包含 非法 字符 的 字符 串 


string 


invalidChars = @"<>\&'"; 





XmlWriterSettings settings = new XmlWriterSettings(); 
settings.Indent = true; 


using (XmlWriter writer = XmlWriter.Create(Console.Out, settings) ) 


{ 
writer .WriteStartELement("Root"); 
writer .WriteStartELement("InvalidCha 
writer .WriteCData(invalidChars) ; 
writer .WriteEndELement(); 
writer 
writer .WriteEndELement(); 

} 

它 的 输出 如 下 所 示 。 


<?xml version="1.0" encoding="IBM437"?> 


<Root> 


rs1"); 


-WriteElementString("InvalidChars2", invalidChars); 


<InvalidChars1><! [CDATA[<>\&' ]]></InvalidChars1> 
<InvalidChars2>&lt; &gt; \&amp; '</InvalidChars2> 
</Root> 


使 用 XmUDocument 和 XmLELement 处 理 该 问题 有 两 种 方法 : 第 一 种 方法 是 将 要 添加 的 文本 放 


置 在 一 个 CDATA 市 中 ， 并 将 其 添加 县 




















// 建立 一 个 包含 非法 字符 的 字符 串 


string 


invalidChars = @"<>\&'"; 


// 创建 第 一 个 非法 字符 节点 


XmLELement invalidElement1 = xmlDoc.CreateElement("InvalidChars1"); 


// 将 





法 字符 封装 在 一 个 CDATA 节 中 ,并 且 使 朋 








HInnerXML 


I| XmLELement 的 InnerXML 属性 中 。 





属性 以 赋值 ， 


自动 转 义 文本 ， 如 创建 Invalidchars2 元 素 时 所 示 。 
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数据 。 


// W 





为 它 并 不 会 转 义 值 , 只 需要 传人 提供 的 文本 


invalidElementi.AppendChild(xmlDoc.CreateCDataSection(invalidChars)); 


第 二 种 方法 如 下 所 示 ， 通 过 将 文本 直接 赋 给 InnerText 属性 ， 让 XmlElement 类 为 你 封装 


// 建立 一 个 包含 非法 字符 的 字符 串 
string invalidChars = @"<>\&'"; 
// 创建 第 二 个 非法 字符 节点 

XmlElement invalidElement2 = xmlDoc.CreateElement("InvalidChars2"); 


// 直接 使 用 InnerText 属 性 添加 非法 字符 以 赋值 ， 
// 因为 它 会 自动 转 义 值 


invalidElement2.InnerText = invalidChars; 








// 将 元 素 追 加 到 根 节点 
root.AppendChild(invalidElement2); 


在 该 代码 中 ， 使 用 XmlElement 生成 了 整个 XmlDocunment, 


public static void HandleInvalidChars() 


{ 








// 建立 一 个 包含 非法 字符 的 字符 串 

string invalidChars = @"<>\&'"; 

XElement element = new XElement("Root", 

new XElement("InvalidCharsi", 
new XCData(invalidChars)), 


new XElement 





("InvalidChars2",invalidChars)); 


Console.WriteLine($"Generated XElement with Invalid Chars:\r\n{element}"); 
Console.WriteLine(); 


XmlWriterSettings settings = new XmlWriterSettings(); 
settings.Indent = true; 
using (XmlWriter writer = XmlWriter.Create(Console.Out, settings) ) 


{ 


} 


writer.WriteStartElement("Root") 


2 


writer .WriteStartElement("InvalidChars1"); 


writer .WriteCData(invalidChars) ; 
writer .WriteEndELlement(); 


writer .WriteELementString("InvalidChars2", invalidChars); 


writer .WriteEndELlement(); 


Console.WriteLine(); 


XmlDocument xmlDoc = new XmlDocument(); 
// 创建 文档 的 根 节 点 
XmlElement root = xmlDoc.CreateElement("Root"); 
xmlDoc.AppendChild(root); 


// 





创建 第 一 个 非法 字符 节点 


XmlElement invalidElement1 = xmlDoc.CreateElement("InvalidChars1"); 


// 将 非法 字符 封装 在 一 个 CDATA 节 中 ,并且 使 用 InnerXxML 属 性 以 赋值 ， 


// 
































因为 它 并 不 会 转 义 值 , 只 需要 传人 提供 





的 文本 


invalidElementi.AppendChild(xmlDoc.CreateCDataSection(invalidChars)); 
// 将 元 素 追 加 到 根 节点 





root .AppendChild(invalidElement1) ; 





// 创建 第 二 个 非法 字符 节点 

XmlElement invalidElement2 = xmlDoc.CreateElement("InvalidChars2"); 
// 直接 使 用 InnerText 属 性 添加 非法 字符 以 赋值 ， 

// 因为 它 会 自动 转 义 值 

invalidElement2.InnerText = invalidChars; 

// 将 元 素 追 加 到 根 节点 

root.AppendChild(invalidElement2); 








Console.WriteLine($"Generated XML with Invalid Chars:\r\n{xmlDoc.OuterXml}"); 
Console.WriteLine(); 


} 
这 一 过 程 所 生成 的 XML (以 及 控制 台 的 输出 ) 如 下 所 示 。 


Generated XML with Invalid Chars: 
<Root><InvalidChars1><![CDATA[<>\&']]></InvalidChars1><InvalidChars2>&lt;&gt;\&a 
mp; '</InvalidChars2></Root> 





10.5.3 ”讨论 

为 便于 输入 ，CDATA 节点 允许 将 文本 片段 中 的 项 表示 为 字符 数据 ， 而 不 是 作为 转 义 的 
XML。 一 般 而 言 ， 这 些 字符 需要 处 于 其 转 义 格式 (例如 ， 对 于 < 是 &Lt;)， 但 是 CDATA 节 
允许 你 将 其 作为 常规 文本 键入 。 

当 CDATA 标签 与 XmlELement 类 的 InnerXml 一 起 使 用 时 ， 你 可 以 提交 通常 需要 被 首先 转 义 的 
字符 。xmLELement 类 还 拥有 一 个 InnerText 属性 ， 它 将 自动 转 义 所 有 被 赋值 的 字符 串 中 发 
现 的 标记 。 这 使 得 你 可 以 添加 这 些 字符 而 无 需 担 心 它们 。 
































10.5.4 ”参考 


MSDN 文档 中 的 “XELement 类 ”“XCData 类 ”“XmlDocument 2E" *"XmlWriter 类 ”“XmLELement 
类 ” 和 “CDATA ah” 主题 。 


10.6 ”转换 XML 


10.6.1 问题 

你 有 一 个 原始 的 XML 文档 ， 需 要 将 它 转换 为 一 种 更 易 阅 读 的 格式 。 例 如 ， 你 拥有 存储 为 
XML 文档 的 个 人 数据 ， 需 要 将 它 显示 在 一 个 网 页 上 或 者 放置 在 以 逗号 分 隔 的 文本 文件 中 
用 于 原 有 系统 集成 。 不 幸 的 是 ， 并 非 所 有 人 都 希望 整 天 对 大 量 XML 进行 分 类 ， 他 们 更 希 
望 以 一 种 格式 化 的 列表 形式 或 者 在 一 个 定义 好 列 和 行 的 表格 中 阅读 数据 。 你 需要 一 个 方法 
将 XML 数据 转换 为 一 种 更 易 读 的 形式 以 及 以 逗号 分 隔 的 格式 。 


10.6.2 ”解决 方案 
本 节 的 解决 方案 使 用 LINQ to XML 在 CH 中 执行 转换 。 在 示例 代码 中 ， 转 换 了 存储 在 
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Personnel.xml 中 来 自 虚 拟 公司 的 一 些 个 人 数据 。 首 先 将 数据 转换 为 HIML， 然 后 转换 为 以 











逗号 分 隔 的 格式 。 
// LINQ 方 式 
XElement personnelData = XElement.Load(@"..\..\Personnel.xmL"); 
// 创建 HTML 
XELement personnelHtml = 
new XElement("html", 
new XElement("head"), 
new XElement("body", 
new XAttribute("title","Personnel"), 
new XElement("p", 
new XElement("table", 
new XAttribute("border","1"), 
new XElement("thead", 
new XElement("tr", 
new XElement("td","Employee Name"), 
new XElement("td","Employee Title"), 
new XElement("td","Years with Company"), 
new XElement("td","Also Known As") 
) 
25 
new XElement("tbody", 
from p in personnelData.Elements("Employee") 
select new XElement("tr", 
new XElement("td", p.Attribute("name").Value), 
new XElement("td", p.Attribute("title").Value), 
new XElement("td", 
p.Attribute("companyYears").Value), 
new XElement("td", p.Attribute("nickname").Value) 
) 
) 
) 
) 
) 
); 
personnelHtml.Save(@"..\..\Personnel_LINQ. html"); 
var queryCSV = from p in personnelData.Elements("Employee") 
orderby p.Attribute("name").Value descending 
select p; 
StringBuilder sb = new StringBuilder(); 
foreach(XElement e in queryCSV) 
{ 
sb.AppendFormat($"{EscapeAttributeForCSV(e, "name")}," + 
$"(EscapeAttributeForCSV(e, "title")}," + 
$"{EscapeAttributeForCSV(e, "companyYears")}," + 
$"{EscapeAttributeForCSV(e, "nickname")}" + 
$" {Environment .NewLine}"); 
} 
using(StreamWriter writer = File.CreateText(@"..\..\Personnel_LINQ.csv")) 
{ 
writer .Write(sb.ToString()); 
} 
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JK LINQ 到 CSV 的 转换 输出 如 下 所 示 。 


Rutherford,CEO,27,""BigTime"" 


Chas,Salesman,3,""Money 
Bob,Customer Service,1,""Happy 
Alice,Manager,12,""Business 


Personnel.xml 文件 包含 下 列 项 。 


<?xml version="1.0" encoding="utf-8" ?> 
«Personnel xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance"> 
<EmpLoyee name="Bob" title="Customer Service" companyYears="1" 


nickname="&quot ; Happy&quot; "/> 


<Employee name="Alice" title="Manager" companyYears="12" 


nickname="&quot; Business&quot; "/> 


<Employee name="Chas" title="Salesman" companyYears="3" 


nickname="&quot ; Money&quot; "/> 


«Employee name="Rutherford" title="CEO" companyYears="27" 


nickname="&quot; BigTime&quot; "/> 


</Personnel> 


你 可 能 想 知 道 为 什么 昵称 属性 值 在 CSV 输出 中 有 额外 的 双 引 号 。 这 是 为 了 支持 RFC 
4180“ 常 见 格式 和 MIME 类 型 为 CSV 文件 ”中 所 说 的 “如 果 双 引号 被 用 于 括 起 字段 ， 
那么 字段 内 出 现 双 引号 时 必须 通过 在 它 前 面 加 上 另 一 个 双 引 号 进行 转 义 。 我 们 使 用 
EscapeAttributeForCSV 方法 完成 此 操作 。 








private static string EscapeAttributeForCSV(XElement element, 
string attributeName) 


( 


string attributeValue - element.Attribute(attributeName).Value; 
//RFC-4180 ,段落 描述 “如 果 双 引号 被 用 于 括 起 字段 ， 

// 那 么 字段 内 出 现 双 引 号 时 ， 

// 必 须 通过 在 它 前 面 加 上 男 一 个 双 引 号 进行 转 义 ” 

return attributeValue.Replace("\"", "\"\""); 


} 


此 方法 在 范例 10.8 (HJ 10.8 节 ) 中 会 进一步 讨论 。 

我 们 还 可 以 通过 使 用 XsLCompiledTransform 类 以 使 用 一 个 XSLT 样式 表 将 XML 转换 为 
其 他 格式 ， 来 实现 这 一 解决 方案 。 首 先 ， 加 载 用 于 生成 HTML 输出 的 样式 表 ， 然 后 通过 
XSLT 使 用 PersonnelHTML.xsl 样式 表 执 行 到 HTML 的 转换 。 之 后 ， 使 用 PersonnelCSV.xsl 
样式 表 将 数据 转换 为 以 逗号 分 隔 的 格式 。 








// 使 | 


























默认 凭据 创建 一 个 解析 器 


XmlUrlResolver resolver = new XmlUrlResolver(); 
resolver.Credentials = System.Net.CredentialCache.DefaultCredentials; 


// 将 personneL.xmt 文 件 转换 为 htmL 

XslCompiledTransform transform = new XslCompiledTransform(); 
XsltSettings settings = new XsltSettings(); 

// 为 安全 原因 禁用 这 两 个 属性 (默认 false) 
settings.EnableDocumentFunction = false; 
settings.EnableScript = false; 


// 加 载 样式 表 
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transform.Load(@"..\..\PersonnelHTML.xsLl",settings,resolver); 
// 执行 转换 


transform.Transform(Q".. V. .VPersonnel.xml",Q".. V. .APersonnel.html"); 


PersonnelHTML.xsl 样式 表 如 下 所 示 。 


<?xml version="1.0" encoding="UTF-8"?> 
<xsl:stylesheet version="1.0" xmlns:xsl="http: //www.w3.0rg/1999/XSL/Transform" 
xmlns:xs="http: //www.w3.org/2001/XMLSchema"> 
<xsl:template match="/"> 
<html> 
<head /> 
<body title="Personnel"> 
<xsl:for-each select="Personnel"> 
<p> 
<xsl:for-each select="Employee"> 
«xsl:if test="position()=1"> 
<table border="1"> 
<thead> 
<tr> 
<td>Employee Name</td> 
<td>Employee Title</td> 
<td>Years with Company</td> 
<td>Also Known As</td> 


</tr> 
</thead> 
<tbody> 
<xsl:for-each select="../Employee"> 
<tr> 
<td> 
<xsl:for-each select="@name"> 
<xsl:value-of select="." /> 
</xsl:for-each> 
</td> 
<td> 
<xsl:for-each select="@title"> 
<xsl:value-of select="." /> 
</xsl:for-each> 
</td> 
<td> 
<xsl:for-each select="@companyYears"> 
<xsl:value-of select="." /> 
</xsl:for-each> 
</td> 
<td> 
<xsl:for-each select="@nickname"> 
<xsl:value-of select="." /> 
</xsl:for-each> 
</td> 
</tr> 
</xsl:for-each> 
</tbody> 
</table> 
</xsl:if> 


</xsl:for-each> 





</p> 
</xsl:for-each> 
</body> 
</html> 
</xsl:template> 
</xsl:stylesheet> 


要 生成 如 图 10-1 所 示 的 HTML 屏幕 输出 ， 可 使 用 PersonnelHTML.xsl 样式 表 和 Personnel. 





xml 文件 。 











Employee Name Employee Title — Years with Company [Also Known As 





[Bob Customer Service |1 
[Alice Manager 12 
[Chas Salesman 3 
Rutherford — |CEO 27 


| "Happy" 
Business" 
"Money" 


l'BigTime" 














图 10-1: 由 Personnel.xml 生成 的 Personnel HTML 表格 





下 面 是 LINQ 转换 生成 的 HTML 源 代码 。 


<?xml version="1.0" encoding="utf-8"?> 
<html> 
<head /> 
<body title="Personnel"> 
<p> 
<table border="1"> 
<thead> 
<tr> 
<td>Employee Name</td> 
<td>Employee Title</td> 
<td>Years with Company</td> 
<td>Also Known As</td> 
</tr> 
</thead> 
<tbody> 
<tr> 
<td>Bob</td> 
<td>Customer Service</td> 
<td>1</td> 
<td>"Happy"</td> 
</tr> 
<tr> 
<td>Alice</td> 
<td>Manager</td> 
<td>12</td> 
<td>"Business"</td> 
</tr> 
<tr> 
<td>Chas</td> 
<td>Salesman</td> 
<td>3</td> 
<td>"Money"</td> 
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要 生成 以 逗号 分 隔 的 输出 ， 可 使 月 


</tr> 


<tr> 
<td>Rutherford</td> 
<td>CE0</td> 
<td>27</td> 
<td>"BigTime"</td> 

</tr> 

</tbody> 
</table> 
</p> 
</body> 
</html> 














lz XSLT 转换 生成 的 HTML 源 代码 。 


<?xml version="1.0" encoding-"utf-8"?» 
<htmL> 
<head /> 
<body title-"Personnel'"» 
<table border="1"> 
<thead> 
<tr> 
<td>Employee Name</td> 
<td>Employee Title</td> 
<td>Years with Company</td> 
</tr> 
</thead> 
<tbody> 
<tr> 
<td name="Bob" /> 
<td title="Customer Service" 
<td name="Bob" /> 
</tr> 
<tr> 
<td name="Alice" /> 
<td title="Manager" /> 
<td name="Alice" /> 
</tr> 
<tr> 
<td name="Chas" /> 
<td title="Salesman" /> 
<td name="Chas" /> 
</tr> 
<tr> 
<td name="Rutherford" /> 
<td title-"CEO" /> 
<td name="Rutherford" /> 
</tr> 
</tbody> 
</table> 
</body> 
</html> 





/> 


H PersonnelCSV.xsl 和 Personnel.xml。 





// 将 personneL.xmt 文 件 转换 为 以 逗号 分 隔 的 格式 
// 加 载 样式 表 


XslCompiledTransform transformCSV = new XslCompiledTransform(); 
XsltSettings settingsCSV = new XsltSettings(); 

// 为 安全 原因 禁用 这 两 个 属性 (默认 false) 
settingsCSV.EnableDocumentFunction = false; 

settingsCSV.EnableScript = false; 
transformCSV.Load(@"..\..\PersonnelCSV.xsLl", settingsCSV, resolver); 














// 执行 转换 

XsltArgumentList xslArg = new XsltArgumentList(); 

CsvExtensionObject xslExt = new CsvExtensionObject(); 

xslarg.AddExtensionObject("urn:xslext", xslExt); 

XPathDocument xPathDoc = new XPathDocument(@"..\..\Personnel.xml"); 

XmlWriterSettings xmlWriterSettings = new XmlWriterSettings(); 

xmlWriterSettings.ConformanceLevel = ConformanceLevel.Fragment; 

using (XmlWriter writer = XmlWriter.Create(@"..\..\Personnel.csv", 
xmlWriterSettings) ) 


{ 
} 


transformCSV.Transform(xPathDoc, xslArg, writer); 


PersonnelCSV.xsl 样式 表 如 下 所 示 。 


<?xml version="1.0" encoding="UTF-8"?> 
«xsl:stylesheet version="1.0" xmlns:xsl="http: //www.w3.0rg/1999/XSL/Transform" 
xmlns:xsz"http: //www.w3.org/2001/XMLSchema" 
xmlns:xslextz"urn:xslext"» 
«xsl:output method="text" encoding="UTF-8"/> 
<xsl:template match="/"> 
<xsl:for-each select="Personnel"> 
<xsl:for-each select="Employee"> 
<xsl:for-each select="@name"> 
<xsl:value-of 
select-"xslext:EscapeAttributeForCSV(string(.))" /> 
</xsl:for-each>,<xsl:for-each select="@title"> 
<xsl:value-of 
select-"xslext:EscapeAttributeForCSV(string(.))" /» 
</xsl:for-each>,<xsl:for-each select="@companyYears"> 
<xsl:value-of 
select-"xslext:EscapeAttributeForCSV(string(.))" /> 
</xsl:for-each>,<xsl:for-each select="@nickname"> 
<xsl:value-of 
select-"xslext:EscapeAttributeForCSV(string(.))" /> 
</xsl:for-each> 
«xsl:text» &#xd;&#xa;</xsl: text> 
</xsl:for-each> 
</xsl:for-each> 
</xsl:template> 
</xsl:stylesheet> 





从 PersonnelCSV.xls 样式 表 产 生 的 输出 如 下 所 示 。 


Bob,Customer Service,1,""Happy 
Alice,Manager,12,""Business"" 
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Chas, Salesman,3,""Money"" 
Rutherford,CEO,27,""BigTime"" 


我 们 再 次 做 一 些 工 作 来 支持 RFC 4180“ 和 常见 格式 和 CSV 文件 MIME 类 型 *。 通 过 Csv- 
ExtensionObject 对 象 上 的 EscapeAttributeForCSV 方法 ， 该 对 象 作 为 Extension 对 象 传递 
到 转换 中 。 在 范例 10.8 (BI 10.8 节 ) 中 将 会 对 其 进行 详细 描述 。 


public class CsvExtensionObject 
{ 
public string EscapeAttributeForCSV(string attributeValue) => 
attributeValue.Replace("V'", "\"\""); 
} 


10.6.3 ”讨论 


XSLT 是 将 XML 从 一 种 格式 转换 为 另 一 种 格式 的 强大 方法 。 话 虽 如 此 ，LINQ 带 给 CH 的 
执行 XML 转换 而 无 需 切换 到 某 些 解析 器 或 进程 的 能 力 非 常 吸 引 人 。 这 意味 着 ， 在 应 用 
程序 中 执行 XML 转换 时 ， 你 再 也 不 必 理 解 XSLT 语法 或 者 同时 维护 应 用 程序 中 的 C# 和 
XSLT 代码 了 。 这 还 意味 着 当 查 看 其 他 团队 成 员 的 代码 时 ， 你 再 也 不 必 查 看 各 个 文件 以 理 
解 转 换 所 做 的 工作 了 ， 代 码 全 部 都 是 C#。 


这 并 不 意味 着 XSLT 作为 一 种 转换 XML 的 方法 是 没 用 或 者 不 合 时 宜 的 ，XSLT 仅仅 不 再 
是 C# 开 发 人 员 的 唯一 首选 了 。XSLT 仍 能 用 于 所 有 NET 中 的 现存 XML API， 并 且 将 继 
续 使 用 下 去 。 我 们 为 你 提出 的 挑战 是 ， 试 着 以 LINQ 实现 现 有 基于 XSLT 的 转换 ， 并 且 亲 
自 看 到 使 用 LINQ 的 可 能 性 。 


当 使 用 XSLT 执行 转换 时 ， 有 许多 XslCompiledTransform.Transform 方法 的 重 写 版 本 。 因 
为 XnlResolver 是 一 个 抽象 类 ， 所 以 需要 使 用 XmlUrlResolver 或 XmlSecureResolver 或 传递 
null 作为 XnlResolver 类 型 的 实 参 。XmlUrlResolver 使 用 FILE、HTTP 和 HTTPS 协议 将 
URL 解析 为 外 部 资源 ， 如 架构 文件 。XmlSecureResolver 通过 要 求 传 人 凭据 以 限制 你 能 够 
访问 的 资源 ， 这 将 有 助 于 防止 XML 中 的 跨 域 重 定向 。 


如 果 你 接受 来 自 互联 网 的 XML， 并 且 没 有 使 用 XmlSecureResolver， 就 可 以 
很 容易 地 重 定向 到 等 待 下 载 并 执行 的 恶意 XML 代码 所 在 的 站 点 。 如 果 为 
XmlResolver 传递 nutL， 那 么 就 表明 你 不 希望 解析 任何 外 部 资源 。Microsoft 
已 经 声明 null 选项 废弃 ， 它 不 应 当 再 使 用 ， 因 为 你 总 是 应 该 使 用 某 种 类 型 
的 XmlResolver, 



















































































XSLT 是 一 种 功能 强大 的 技术 ， 人 允许 你 将 XML 转换 为 可 以 想到 的 任何 格式 ， 但 它 偶尔 也 
可 能 令 人 心烦 。XSLT 输出 回 车 /换行 组 合 的 简单 需求 非常 麻烦 ， 我 们 能 够 找到 20 多 种 不 
同 的 留言 板 请 求 帮助 如 何 完 成 它 ! 在 查看 了 针对 XSLT 的 W3C 规范 后 ， 我 们 发 现 你 可 以 
如 下 使 用 xsl:text 元 素来 完成 这 一 点 。 


«xsl:text» &ixd;8Hxa;«/xsl:text» 


&#xd; 代表 十 六 进 制 的 13 或 者 一 个 回 车 ， 而 8#xa; 代表 十 六 进 制 的 10 或 者 一 个 换行 。 这 
就 是 来 自 XML 每 个 雇员 数据 尾部 的 输出 。 
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10.6.4 ”参考 


MSDN 文档 中 的 “XsLCompiLedTransform 类 
SecureResolver 类 ”和 “xsL:text” 主 题 。 


10.7 ”验证 修改 过 的 XML 文档 而 无 需 重 新 加 载 


10.7.1 问题 


你 正在 使 用 XDocument 或 XmlDocunent 修改 内 存 中 加 载 的 某 个 XML 文档 。 一 旦 文档 已 被 修 
改 ， 那 么 需要 验证 修改 并 确保 架构 默认 值 。 


10.7.2 解决 方案 
使 用 XDocument. Validate 方法 执行 验证 并 应 用 模式 默认 值 和 类 型 信息 


使 用 XML 架构 文档 (book.xsd) 和 一 个 XmlReader 创建 一 个 XmlSchemaSet, Jr; [i HH 
XDocument .Load 加 载 book.xml 文件 ， 代 码 如 下 所 示 。 


// 创建 架构 集 
XmlSchemaSet xmlSchemaSet = new XmlSchemaSet(); 
" 将 新 的 架构 添加 到 目标 命名 空间 
/ (如 果 存 在 多 个 架构 ,可 以 一 次 添加 全 部 ) 
le Add("http: //tempuri.org/Book.xsd", 
XmLReader.Create(@"..\..\Book.xsd")); 
XDocument book = XDocument.Load(@"..\..\Book.xml"); 


建立 一 个 ValidationEventHandler 以 捕获 所 有 错误 ， 然 后 使 用 架构 集合 和 事件 处 理 程序 调 
用 XDocument.Validate， 根 据 book.xsd 模式 验证 book.xml， 代 码 如 下 所 示 。 


ValidationHandler validationHandler = new ValidationHandler(); 

ValidationEventHandler validationEventHandler = 
validationHandler.HandleValidation; 

// 加 载 后 进行 验证 

book.Validate(xmlSchemaSet, validationEventHandler); 


ValidationHandler 类 在 ValidateXml 属性 中 持 有 当前 验证 状态 以 及 用 于 实现 
ValidationEventHandler 的 方法 HandleValidation 的 代码 。 


» & » & 


XmlResolver 2E" “XmlUrlResolver 2E" “Xml- 






































public class ValidationHandler 


( 


private object _syncRoot = new object(); 


public ValidationHandler() 





{ 
lock(, syncRoot) 
// 设置 验证 初始 检查 为 true 
this.ValidXml = true; 
} 
} 
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public bool ValidXml { get; private set; } 


public void HandleValidation(object sender, ValidationEventArgs e) 


{ 


} 


lock( syncRoot) 


// 方法 被 调用 ,说 明 验 证 未 通过 
ValidXml = false; 
Console.WriteLine($"Validation Error 
Console.WriteLine($"Validation Error 
Console.WriteLine($"Validation Error 


$"((e.Exception?. 


Console.WriteLine($"Validation Error 


$"((e.Exception?. 


Console.WriteLine($"Validation Error 


Console.WriteLine($"Validation Error Source Schema: 


Message: {e.Message}"); 
Severity: {e.Severity}"); 
Line Number: " + 
LineNumber}"); 
Line Position: 
LinePosition}"); 

Source: {e.Exception?.Source}"); 
”十 


+ 


"fe. Exception? .SourceSchemaObject}"); 


Console.WriteLine($"Validation Error 


$"((e.Exception?. 


Console.WriteLine($"Validation Error 


$"((e.Exception?. 


Console.WriteLine($"Validation Error 


$"((e.Exception?. 


Source Uri: * 
SourceUri]"); 
thrown from: 
TargetSite}"); 
callstack: " + 


StackTrace}"); 


+ 


如 果 你 想 知道 上 述 代码 示例 中 lock 语句 是 什么 ， 请 查看 范例 12.2 (Hl 12.249) 中 的 完整 
解释 。 简 而 言 之 ， 在 lock 语句 中 不 能 运行 多 个 线程 。 
向 XDocument 中 添加 一 个 架构 中 没有 的 新 元 素 节 点 ， 然 后 使 用 架构 集合 和 事件 处 理 程序 再 
次 调用 Validate， 以 重修 验证 修改 过 的 XDocunent。 如 果 文 档 触 发 了 任何 验证 事件 ， 那 么 
将 ValidationHandler 实例 中 的 validationHandler.ValidXml 属性 设置 为 faLse。 


// 添加 不 在 架构 中 的 新 节点 


// W 














为 我 们 已 经 验证 过 了 ,所 以 添加 时 不 会 触发 回调 

















book .Root .Add(Cnew XElement("BogusElement","Totally")); 
// 现在 验证 新 添加 的 内 容 


book.Validate(xmlSchemaSet, validationEventHandler); 


if (validationHandler.ValidXml) 
Console.WriteLine("Successfully validated modified LINQ XML"); 


else 


Console.WriteLine( "Modified LINQ XML did not validate successfully"); 
Console.WriteLine(); 


你 还 可 以 使 用 XmUDocument. Validate 方法 对 XDocument 以 类 似 的 方式 执行 验证 ， 代 码 如 下 


所 示 。 


string xmlFile 
string xsdFile 


..\..\Book. xml"; 


= @" 
= @"..\..\Book.xsd"; 


// 创建 架构 集 





XmlSchemaSet schemaSet = new XmlSchemaSet(); 
y 将 新 的 架构 添加 到 目标 命名 空间 


/ 《如 果 存 在 多 个 架构 ,可 以 一 次 添加 全 部 ) 
re Add("http://tempuri.org/Book.xsd", XmlReader.Create(xsdFile)); 








// 加 载 xml 文 件 


XmlDocument xmlDoc = new XmlDocument(); 
// 添加 架构 


xmlDoc.Schemas = schemaSet; 


将 bool.xml 文件 加 载 到 XmlDocument 中 ， 建 立 一 个 ValidationEventHandler 以 捕获 所 有 错 
误 。 然 后 使 用 事件 处 理 程序 调用 Validate, fiii book.xsd 架构 验证 book.xml， 代 码 如 下 
所 示 。 


// 加 载 完成 之 后 进行 验证 
xmlDoc.Load(xmlFile); 
ValidationHandler handler - new ValidationHandler(); 
ValidationEventHandler eventHandler - handler.HandleValidation; 
xmlDoc.Validate(eventHandler); 


[n] XmlDocument 中 添加 一 个 架构 中 不 存在 的 新 元 素 ， 然 后 使 用 事件 处 理 程序 再 次 调用 
Validate， 以 便 重新 验证 修改 过 的 XmtDocunent。 如 果 文 档 触发 了 任何 验证 事件 ， 那 么 将 
ValidationHandler.ValidXml 属性 设置 为 false, 


// 添加 不 在 架构 中 的 新 节点 

// 因为 我 们 已 经 验证 过 了 ,所 以 添加 时 不 会 触发 回调 

XmLNode newNode = xmlDoc.CreateElement("BogusElement"); 
newNode.InnerText = "Totally"; 

// 添加 新 元 素 
xmlDoc.DocumentElement.AppendChild(newNode); 

// 现在 验证 新 添加 的 内 容 


xmlDoc.Validate(eventHandler); 
















































































if (handler.ValidXml) 
Console.WriteLine("Successfully validated modified XML"); 
else 
Console.WriteLine("Modified XML did not validate successfully"); 


10.7.3 讨论 
使 用 XmLDocument 而 不 是 XDocument 的 一 个 好 处 在 于 ， 存 在 一 个 XmlDocument.Validate 的 
重 载 ， 允 许 传人 一 个 特定 的 XnlNode 进行 验证 。XDocument 上 不 存在 如 此 细 粒 度 的 控制 。 


public void Validate( 
ValidationEventHandler validationEventHandler, 
XmlNode nodeToValidate 


ig 





)s 


解决 这 一 问题 的 另 一 个 方法 是 使 用 XmLDocument 实例 化 XmLNodeReader 的 一 个 实例 ， 然 后 使 
用 验证 设置 创建 一 个 xmLReader， 如 范例 10.3 (HJ 10.3 节 ) 所 示 。 当 读 取 器 es XML 
时 ， 它 允许 进行 连续 验证 。 
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运行 该 代码 的 输出 如 下 所 示 。 


Validation Error Message: The element 'Book' in namespace 'http://tempuri.org/Bo 
ok.xsd' has invalid child element 'BogusElement'. List of possible elements expe 
cted: 'Chapter' in namespace 'http://tempuri.org/Book.xsd'. 

Validation Error Severity: Error 

Validation Error Line Number: 0 

Validation Error Line Position: 0 

Validation Error Source: 

Validation Error Source Schema: 

Validation Error Source Uri: 

Validation Error thrown from: 

Validation Error callstack: 

Modified LINQ XML did not validate successfully 


Validation Error Message: The element 'Book' in namespace 'http://tempuri.org/Bo 
ok.xsd' has invalid child element 'BogusElement'. List of possible elements expe 
cted: 'Chapter' in namespace 'http://tempuri.org/Book.xsd' 

Validation Error Severity: Error 

Validation Error Line Number: 0 

Validation Error Line Position: 0 

Validation Error Source: 

Validation Error Source Schema: 

Validation Error Source Uri: file:///C:/CSCB6/CSharpRecipes/Book. xml 

Validation Error thrown from: 

Validation Error callstack: 

Modified XML did not validate successfully 


要 注意 ， 用 户 添加 的 BogusElement 元 素 不 是 用 于 Book 元 素 的 架构 组 成 部 分 ， 因 此 你 得 到 
了 一 个 带 有 关于 错误 发 生地 点 信息 的 验证 错误 事件 。 最 后 ， 将 针对 得 到 的 一 个 报告 ， 说 明 
修改 的 XML 未 能 正确 地 验证 。 








10.7.4 ”参考 


范例 10.2 (HI 10.2 节 ) ; MSDN 文档 中 的 “XDocument 类 ”和 “XmlDocument.Validate” 


Y 


主题 。 


10.8 扩展 转换 


10.8.1 问题 
你 希望 执行 超出 转换 技术 范 


10.8.2 ”解决 方案 


如 果 你 使 用 LINQ to XML， 那 么 可 以 在 转换 结果 集 时 直接 调用 一 个 函数 ， 下 面 是 对 
GetErrata 的 调用 。 


XElement publications = XElement.Load(@"..\..\publications.xml"); 
XELement transformedPublications = 





aor 








之 外 的 操作 ， 以 在 转换 后 的 结果 中 包含 数据 。 


























new XElement("PublishedWorks", 
from b in publications.Elements("Book") 
select new XElement(b.Name, 
new XAttribute(b.Attribute("name")), 
from c in b.Elements("Chapter") 
select new XElement("Chapter", GetErrata(c)))); 
Console.WriteLine(transformedPublications.ToString()); 
Console.WriteLine(); 


上 述 示例 中 使 用 的 GetErrata 方法 如 下 所 示 。 


private static XElement GetErrata(XElement chapter) 





{ 
// 此 处 我 们 可 以 进行 其 他 的 查找 操作 (XML .数据库 和 Web 服 务 ) 
// 以 获得 信息 并 添加 到 转换 结果 中 
string errata = $"{chapter.Value} has {chapter.Value.Length} errata"; 
return new XElement("Errata", errata); 
} 


如 果 你 使 用 XSLT， 那 么 可 以 向 转换 添加 一 个 扩展 对 象 ， 它 可 以 根据 传 入 的 布点 执行 所 需 
的 操作 。 通 过 使 用 XsltArgumentList.AddExtension0bject 方法 可 以 达成 这 一 工作 。 你 创建 
的 对 象 (XslExtensionobject) 可 在 XSLT 中 进行 访问 ， 调 用 其 上 的 方法 可 返回 你 希望 在 








最 终 转 换 结果 中 包含 的 数据 。 


string xmlFile = @"..\..\publications.xmL"; 
string xslt = Q@"..\..\publications.xsl"; 





// 创建 XxsLCompiLedTransform 并 加 载 样式 表 
XslCompiledTransform transform = new XslCompiledTransform(); 
transform.Load(xslt); 

// 加 载 xm 

XPathDocument xPathDoc = new XPathDocument(xmlFile); 


// 使 用 扩展 对 象 创建 样式 表 参 数 

XsltArgumentList xslArg = new XsltArgumentList(); 
XslExtensionObject xslExt = new XslExtensionObject(); 
xslaArg.AddExtensionObject("urn:xslext", xslExt); 























// 将 输出 发 送 到 控制 台 并 执行 转换 
using (XmlWriter writer = XmlWriter.Create(Console.Out)) 


{ 
} 


transform. Transform(xPathDoc, xslArg, writer); 

















要 注意 ， 当 扩展 对 象 添加 到 XsltArgumentList 中 时 ， 它 提供 了 一 个 urn:xslext 命名 空 
间 。 该 命名 空间 在 XSLT 样式 表 中 使 用 ， 以 引用 到 该 对 象 。XSLExtension0bject 的 定义 





如 下 所 示 。 
// 为 功能 提供 帮助 的 扩展 对 象 


public class XslExtensionObject 


( 














public XPathNodeIterator GetErrata(XPathNodeIterator nodeChapter) 





// 此 处 我 们 可 以 进行 其 他 的 查找 操作 (XML 数据库 和 Web 服务 ) 
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g 








// VAIRE EARE A RA 

nodeChapter .MoveNext(); 

string errata = $"<Errata>{nodeChapter.Current.Value} has 
$"{nodeChapter.Current.Value.Length} errata</Errata>"; 

XmlDocument xDoc = new XmlDocument(); 

xDoc.LoadXml (errata); 

XPathNavigator xPathNav = xDoc.CreateNavigator(); 

xPathNav.MoveToChild(XPathNodeType. Element); 

XPathNodeIterator iter = xPathNav.Select("."); 

return iter; 








+ 


} 


在 执行 XSLT 样式 表 期 间 ， 调 用 GetErrata 方法 向 转换 提供 XPathNodeIterator 格式 的 数 
tH. xmlns:xslext 命名 空间 被 声明 为 urn:xstext， 它 匹配 作为 转换 的 实 参 传 人 的 命名 空间 
值 。 在 处 理 用 于 每 个 Chapter 的 Book 模板 时 ， 使 用 包含 对 xslext:GetErrata 方法 的 调用 的 
select 标准 来 调用 xsl:value-of。 该 样式 表 如 下 所 示 。 


<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.0rg/1999/XSL/Transform" 
xmlns:xslext="urn:xslext"> 
<xsl:template match="/"> 
<xsl:element name="PublishedWorks"> 
<xsl:apply-templates/> 
</xsl:element> 
</xsl:template> 
<xsl:template match="Book"> 
<Book> 
<xsl:attribute name ="name"> 
<xsl:value-of select="@name"/> 
</xsl:attribute> 
<xsl:for-each select="Chapter"> 
<Chapter> 
<xsl:value-of select="xslext:GetErrata(/)"/> 
</Chapter> 
</xsl:for-each> 
</Book> 
</xsl:template> 
</xsl:stylesheet> 


这 两 种 方法 输出 相同 ， 看 起 来 如 下 所 示 (部 分 清单 )。 


«PublishedWorks» 
«Book name="Subclassing and Hooking with Visual Basic"> 
«Chapter» 
<Errata>Introduction has 12 errata</Errata> 
</Chapter> 























</Book> 
<Book name="C# Cookbook"> 
<Chapter> 
<Errata>Numbers has 7 errata</Errata> 
</Chapter> 


</Book> 





<Book name="C# Cookbook 2.0"> 
<Chapter> 
<Errata>Numbers and Enumerations has 24 errata</Errata> 
</Chapter> 
</Book> 
<Book name="C# 3.0 Cookbook"> 
<Chapter> 
<Errata>Language Integrated Query (LINQ) has 32 errata</Errata> 
</Chapter> 
</Book> 
<Book name="C# 6.0 Cookbook"> 
<Chapter> 
<Errata>Classes and Generics has 20 errata</Errata> 
</Chapter> 
<Chapter> 
<Errata>Collections, Enumerators, and Iterators has 39 errata</Errata> 
</Chapter> 
<Chapter> 
<Errata>Data Types has 10 errata</Errata> 
</Chapter> 
<Chapter> 
<Errata>LINQ and Lambda Expressions has 27 errata</Errata> 
</Chapter> 
<Chapter> 
<Errata>Debugging and Exception Handling has 32 errata</Errata> 
</Chapter> 
<Chapter> 
<Errata>Reflection and Dynamic Programming has 34 errata</Errata> 
</Chapter> 
<Chapter> 
<Errata>Regular Expressions has 19 errata</Errata> 
</Chapter> 
<Chapter> 
<Errata>Filesystem I/O has 14 errata</Errata> 
</Chapter> 
<Chapter> 
<Errata>Networking and Web has 18 errata</Errata> 
</Chapter> 
<Chapter> 
<Errata>XML has 3 errata</Errata> 
</Chapter> 
<Chapter> 
<Errata>Security has 8 errata</Errata> 
</Chapter> 
<Chapter> 
<Errata>Threading, Synchronization, and Concurrency has 43 errata</Errata> 
</Chapter> 
<Chapter> 
<Errata>Toolbox has 7 errata</Errata> 
</Chapter> 
</Book> 
«[PublishedWorks» 
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10.8.3 iit 


使 用 LINQ to XML， 你 可 以 扩展 自己 的 转换 代码 ， 通 过 简单 地 添加 知道 如 何 操作 和 返回 
XElement 的 方法 调用 ， 以 包含 额外 的 逻辑 。 它 简单 地 将 另 一 个 方法 调用 添加 到 生成 结果 集 
的 查询 中 ， 而 且 不 会 因 调 用 带 来 任何 额外 的 性 能 问题 。 当 然 ， 如 果 操 作 的 开销 大 ， 那 么 也 
可 能 会 令 转 换 变 慢 ， 但 这 个 问题 在 测试 你 的 代码 时 很 容易 定位 。 


调用 来 自 一 个 XSLT 样式 表 内 部 的 用 户 定制 代码 的 能 力 是 非常 强大 的 ， 但 使 用 时 应 当 小 
心 。 如 下 向 样式 表 中 添加 代码 通常 会 令 它们 在 其 他 环境 中 变 得 无 用 。 如 果 不 必 使 用 样式 表 
在 其 他 解析 器 中 转换 XML， 那 么 对 于 以 常规 XSLT 语法 难以 或 无 法 完成 的 工作 ， 它 可 能 
是 一 种 好 方法 。 


解决 方案 使 用 的 示例 数据 如 下 所 示 。 


<?xml version="1.0" encoding="utf-8"?> 
<Publications> 

<Book name="Subclassing and Hooking with Visual Basic"> 
<Chapter>Introduction</Chapter> 
<Chapter>Windows System-Specific Information</Chapter> 
<Chapter>The Basics of Subclassing and Hooks</Chapter> 
<Chapter>Subclassing and Superclassing</Chapter> 
<Chapter>Subclassing the Windows Common Dialog Boxes</Chapter> 
<Chapter>ActiveX Controls and Subclassing</Chapter> 
<Chapter>Superclassing</Chapter> 
<Chapter>Debugging Techniques for Subclassing</Chapter> 
<Chapter>WH_CALLWNDPROC</Chapter> 
<Chapter>WH_CALLWNDPROCRET</Chapter> 
<Chapter>WH_GETMESSAGE</Chapter> 
<Chapter>WH_KEYBOARD and WH_KEYBOARD_LL</Chapter> 
<Chapter>WH_MOUSE and WH_MOUSE_LL</Chapter> 
<Chapter>WH_FOREGROUNDIDLE</Chapter> 
<Chapter>WH_MSGFILTER</Chapter> 
<Chapter>WH_SYSMSGFILTER</Chapter> 
<Chapter>WH_SHELL</Chapter> 
<Chapter>WH_CBT</Chapter> 
<Chapter>WH_JOURNALRECORD</Chapter> 
<Chapter>WH_JOURNALPLAYBACK</Chapter> 
<Chapter>WH_DEBUG</Chapter> 
<Chapter>Subclassing .NET WinForms</Chapter> 
<Chapter>Implementing Hooks in VB.NET</Chapter> 

</Book> 

<Book name="C# Cookbook"> 
<Chapter>Numbers</Chapter> 
<Chapter>Strings and Characters</Chapter> 
<Chapter>Classes And Structures</Chapter> 
<Chapter>Enums</Chapter> 
<Chapter>Exception Handling</Chapter> 
<Chapter>Diagnostics</Chapter> 
<Chapter>Delegates and Events</Chapter> 
<Chapter>Regular Expressions</Chapter> 
<Chapter>Collections</Chapter> 
<Chapter>Data Structures and Algorithms</Chapter> 
<Chapter>File System I0</Chapter> 




































































<Chapter>Reflection</Chapter> 
<Chapter>Networking</Chapter> 
<Chapter>Security</Chapter> 
<Chapter>Threading</Chapter> 
<Chapter>Unsafe Code</Chapter> 
<Chapter>XML</Chapter> 

</Book> 

<Book name="C# Cookbook 2.0"> 
<Chapter>Numbers and Enumerations</Chapter> 
<Chapter>Strings and Characters</Chapter> 
<Chapter>Classes And Structures</Chapter> 
<Chapter>Generics</Chapter> 
<Chapter>Collections</Chapter> 
<Chapter>Iterators and Partial Types</Chapter> 
<Chapter>Exception Handling</Chapter> 
<Chapter>Diagnostics</Chapter> 
<Chapter>Delegates, Events, and Anonymous Methods</Chapter> 
<Chapter>Regular Expressions</Chapter> 
<Chapter>Data Structures and Algorithms</Chapter> 
<Chapter>File System I0</Chapter> 
<Chapter>Reflection</Chapter> 
<Chapter>Web</Chapter> 
<Chapter>XML</Chapter> 
<Chapter>Networking</Chapter> 
<Chapter>Security</Chapter> 
<Chapter>Threading and Synchronization</Chapter> 
<Chapter>Unsafe Code</Chapter> 
<Chapter>Toolbox</Chapter> 

</Book> 

<Book name="C# 3.0 Cookbook"> 
<Chapter>Language Integrated Query (LINQ)</Chapter> 
<Chapter>Strings and Characters</Chapter> 
<Chapter>Classes And Structures</Chapter> 
<Chapter>Generics</Chapter> 
<Chapter>Collections</Chapter> 
<Chapter>Iterators, Partial Types, and Partial Methods </Chapter> 
<Chapter>Exception Handling</Chapter> 
<Chapter>Diagnostics</Chapter> 
<Chapter>Delegates, Events, and Lambda Expressions</Chapter> 
<Chapter>Regular Expressions</Chapter> 
<Chapter>Data Structures and Algorithms</Chapter> 
<Chapter>File System I0</Chapter> 
<Chapter>Ref lection</Chapter> 
<Chapter>Web</Chapter> 
<Chapter>XML</Chapter> 
<Chapter>Networking</Chapter> 
<Chapter>Security</Chapter> 
<Chapter>Threading and Synchronization</Chapter> 
<Chapter>Toolbox</Chapter> 
<Chapter>Numbers and Enumerations</Chapter> 

</Book> 

<Book name="C# 6.0 Cookbook"> 
<Chapter>Classes and Generics</Chapter> 
<Chapter>Collections, Enumerators, and Iterators</Chapter> 
<Chapter>Data Types</Chapter> 
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<Chapter>LINQ and Lambda Expressions</Chapter> 
<Chapter>Debugging and Exception Handling</Chapter> 
<Chapter>Reflection and Dynamic Programming</Chapter> 
<Chapter>Regular Expressions</Chapter> 
<Chapter>Filesystem I/0</Chapter> 
<Chapter>Networking and Web</Chapter> 
<Chapter>XML</Chapter> 
<Chapter>Security</Chapter> 
<Chapter>Threading, Synchronization, and Concurrency</Chapter> 
<Chapter>Toolbox</Chapter> 
</Book> 
</Publications> 


10.8.4 ”参考 
MSDN 文档 中 的 “使 用 LINQ 进行 数据 转换 ”和 “XsttArgumentList 类 ”主题 。 


10.9 从 现 有 XML 文件 批量 获取 架构 


10.9.1 问题 


你 进入 了 一 个 新 项 目 ， 在 其 中 使 用 XML 进行 数据 传输 ， 但 在 你 之 前 到 来 的 程序 员 由 于 某 
种 原因 未 使 用 XSD。 你 需要 为 每 个 XML 示例 生成 开始 的 架构 文件 。 


10.9.2 ”解决 方案 


使 用 XnlSchemaInference 类 从 XML 示例 中 推导 出 架构 。 例 10-7 中 的 GenerateSchemasFor - 
Directory 国 数 枚 举 了 给 定 目 录 中 的 所 有 XML 文件 并 使 用 GenerateschemasForFile 方法 处 
理 每 一 个 文件 。GenerateSchemasForFile 使 用 XmlSchemaInference.InferSchema 方法 获得 针 
对 给 定 XML 文件 的 架构 。 一 旦 确定 了 所 有 架构 ， 那 么 GenerateSchemasForFile 会 遍历 集 
合 ， 并 使 用 Filestream 将 每 个 架构 保存 成 一 个 XSD 文件 。 


例 10-7: 生成 一 个 XML 架构 
public static void GenerateSchemasForFile(string file) 


{ 























T 





// 设置 此 文件 的 读 取 器 
using (XmlReader reader = XmlReader.Create(file)) 


{ 


XmlSchemaSet schemaSet = new XmlSchemaSet(); 
XmlSchemaInference schemaInference - 
new XmlSchemaInference(); 


// 获得 架构 


schemaSet = schemaInference.InferSchema(reader); 


string schemaPath = string.Empty; 
foreach (XmlSchema schema in schemaSet.Schemas()) 


UD 





// 创建 架构 文件 并 将 架构 写 到 文件 
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} 


schemaPath = $"{Path.GetDirectoryName(file)}\\" + 
$"{Path.GetFileNameWithoutExtension(file)}.xsd"; 
using (FileStream fs = 
new FileStream(schemaPath, FileMode.OpenOrCreate)) 
{ 
schema.Write(fs); 
fs.Flush(); 


public static void GenerateSchemasForDirectory(string dir) 


{ 


// 确认 目录 存在 








if (Directory.Exists(dir)) 


{ 


} 
可 以 如 下 调 月 
// 获得 当 


Directo 
string 


// 生成 


Generat 


10.9.3 


拥有 用 于 某 一 


// 获得 目录 中 的 文件 列表 
string[] files = Directory.GetFiles(dir, "*.xml"); 
foreach (string file in files) 


{ 
j 





GenerateSchemasForFile(file); 





H GenerateSchemasForDirectory 方法 。 


当前 运行 目录 的 向 上 两 个 级 别 的 目录 

ryInfo di = new DirectoryInfo(@"..\.."); 
dir = di.FullName; 

架构 


eSchemasForDirectory(dir); 


讨论 


应 用 程序 中 的 XML 文件 的 XSD ， 能 够 进行 以 下 几 项 工作 。 








。 验证 系统 中 存在 的 XML 
。 用 文档 记录 数据 语义 
。 通过 XML 读 取 方法 以 编程 方式 发 现 数据 结构 


使 用 GenerateSchemasForFile 方法 可 以 快速 启动 开发 XML 架构 的 过 程 ， 但 每 个 架构 应 当 
由 负责 产生 XML 的 团队 成 员 进 行 复 查 。 这 有 助 于 确保 架构 声明 的 规则 是 正确 的 ， 还 可 以 
确保 添加 诸如 模式 默认 值 的 附加 项 和 其 他 关系 。 示 例 XML 文档 中 未 存在 的 所 有 关系 将 被 




















架构 生成 器 忽略 。 
10.9.4 ”参考 


MSDN 文档 中 的 “XmlSchemaInference 类 ”和 “XML 架构 (XSD) 参考 ”主题 。 
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10.10 ”将 参数 传递 给 转换 


10.10.1 问题 


你 时 ` 
你 不 


对 于 少数 在 转换 过 程 中 可 能 发 生 改 变 的 数据 项 ， 
望 对 每 种 变化 都 使 用 一 个 单独 的 机 制 。 





10.10.2 ”解决 方案 


如 果 用 户 使 用 LINQ to XML， 那 么 可 以 简单 地 构建 一 个 方法 ， 封 装 转换 代码 并 向 方法 传递 
参数 ， 就 像 你 对 其 他 代码 通常 所 做 的 一 样 。 











// 使 用 LINQ 而 非 XSLT 转 换 数 据 


string storeTitle = "Hero Comics Inventory"; 

string pageDate = DateTime.Now.ToString("F"); 

XElement parameterExample = XELement.Load(@"..\..\ParameterExample.xmL"); 
string htmlPath = @"..\..\ParameterExample_LINQ.htm"; 
TransformWithParameters(storeTitle, pageDate, parameterExample, htmlPath); 


// 现在 改变 参数 

storeTitle = "Fabulous Adventures Inventory"; 

pageDate = DateTime.Now.ToString("D"); 

htmlPath = @"..\..\ParameterExample2_LINQ.htm"; 
TransformWithParameters(storeTitle, pageDate, parameterExample, htmlPath); 





TransformWithParameters 方法 如 下 所 示 。 


private static void TransformWithParameters(string storeTitle, string pageDate, 
XElement parameterExample, string htmlPath) 
{ 
XElement transformedParameterExample = 
new XElement("html", 
new XElement("head"), 
new XElement("body", 
new XElement("h3", $"Brought to you by {storeTitle} " + 
$"on {pageDate}{Environment.NewLine}"), 
new XElement("br"), 
new XElement("table", 
new XAttribute("border","2"), 
new XElement("thead", 
new XElement("tr", 
new XElement("td", 
new XElement("b","Heroes")), 
new XElement("td", 
new XElement("b","Edition")))), 
new XElement("tbody", 
from cb in parameterExample.Elements("ComicBook") 
orderby cb.Attribute("name").Value descending 
select new XElement("tr", 
new XElement("td",cb.Attribute("name").Value), 
new XElement("td", 
cb.Attribute("edition").Value)))))); 





transformedParam 


} 

















如 果 你 使 用 XSLT 执行 转换 ， 那 么 可 使 月 


eterExample.Save(htmlPath); 





H XsltArgumentList 类 向 XSLT 转换 传递 参数 。 





这 一 技术 允许 程序 生成 用 于 样式 表 的 对 象 (例如 一 个 动态 字符 串 )， 当 样式 表 转 换 给 定 
XML 文档 时 访问 此 对 象 。 在 下 列 示 例 中 ，storeTitle 和 pageDate 参数 被 传递 给 转换 。 
storeTitle 用 于 连环 画 商店 的 店名 ，pageDate 是 运行 报告 的 日 期 。 使 用 XsLtArgumentList 
对 象 的 实例 args 的 AddParan 方法 添加 它们 。 


// 使 用 XSLT 和 参数 转换 























XsltArgumentList arg 


args.AddParam("storeTitle", 


S = new XsltArgumentList(); 
"", "Hero Comics In 


ventory"); 


args.AddParam("pageDate", "", DateTime.Now.ToString("F")); 




















// 使 用 默认 凭据 创建 一 个 解析 器 


XmlUrlResolver resol 


ver = new XmlUrlResolver(); 


resolver.Credentials = System.Net.CredentialCache.DefaultCredentials; 


XsltSettings 类 允许 修改 转换 的 行为 。 如 果 你 使 用 XsltSettings.Default 实例 ， 那 么 在 转 


换 时 不 允许 编写 脚本 或 者 
式 表 来 自 一 个 可 信 源 ， 你 





EJH document XSLT pa zx, 
可 以 创建 一 个 XsltSettings 





对 代码 进一步 修改 可 以 令 其 使 用 不 可 信和 的 XSLT 样式 表 。 





因为 它们 可 能 存在 安全 风险 。 如 果 样 
对 象 并 使 用 ， 但 是 还 是 安全 一 些 好 。 





XslCompiledTransform transform = new XslCompiledTransform(); 


// 加 载 样式 表 





transform.Load(@"..\..\ParameterExample.xslt", XsltSettings.Default, 


resolver); 


// 执行 转换 


FileStream fs = null; 


using (fs = 


new FileStream(@"..\..\ParameterExample.htm", 
FileMode.OpenOrCreate, FileAccess.Write) ) 


transform. Transform(@"..\..\ParameterExample.xml", args, fs); 
} XslCompiledTransform transform = new XslCompiledTransform(); 
// Load up the stylesheet. 
transform.Load(@"..\..\ParameterExample.xslt", XsltSettings.Default, 


resolver); 


// Perform the transformation. 


FileStream fs - 


null; 


using (fs = new FileStream(@"..\..\ParameterExample.htm", 
FileMode.OpenOrCreate, FileAccess.Write)) 


{ 


transform. Transform(@"..\..\ParameterExample.xml", args, fs); 


J 





为 了 显示 使 用 不 同 参数 的 情况 ， 现 在 你 可 以 修改 storeTitle 和 pageDate 并 再 次 运行 转换 。 


// 现在 修改 参数 并 重新 处 理 
args = new XsltArgumentList(); 





args.AddParam("storeTitle", 


, "Fabulous Adventures Inventory"); 


args.AddParam("pageDate", "", DateTime.Now.ToString("D")); 
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using (fs = new FileStream(@"..\..\ParameterExample2.htm", 
FileMode.OpenOrCreate, FileAccess.Write)) 


{ 
} 


ParameterExample.xml 文件 包含 下 列 内 容 。 


transform.Transform(Q"..V..VParameterExample.xml", args, fs); 


<?xml version="1.0" encoding="utf-8" ?> 
<?xml-stylesheet href="ParameterExample.xslt" type="text/xsl"?> 
<ParameterExampLle> 
<ComicBook name="The Amazing Spider-Man" edition="1"/> 
<ComicBook name="The Uncanny X-Men" edition="2"/> 
<ComicBook name="Superman" edition="3"/> 
<ComicBook name="Batman" edition="4"/> 
<ComicBook name="The Fantastic Four" edition="5"/> 
</ParameterExample> 


ParameterExample.xlst 文件 包含 下 列 内 容 。 





<?xml version="1.0" encoding="UTF-8" ?> 
«xsl:stylesheet version="1.0" xmlns:xsl-"http://www.w3.0rg/1999/XSL/Transform"» 
«xsl:output method-"html" indent="yes" /> 
«xsl:param name="storeTitle"/> 
«xsl:param name="pageDate"/> 
<xsl:template match="ParameterExample"> 
<html> 
<head/> 
<body> 
<h3> 
<xsl:text>Brought to you by </xsl:text> 
<xsl:value-of select="$storeTitle"/> 
<xsl:text> on «/xsl:text» 
<xsl:value-of select="$pageDate"/> 
«xsl:text» &#xd;&#xa;</xsl: text> 
</h3> 
<br/> 
<table border="2"> 
<thead> 
<tr> 
<td> 
<b>Heroes</b> 
</td> 
<td> 
<b>Edition</b> 
</td> 
</tr> 
</thead> 
<tbody> 
«xsl:apply-templates/» 
</tbody> 
</table> 
</body> 
</html> 
</xsl:template> 
<xsl:template match="ComicBook"> 





<tr> 
<td> 
<xsl:value-of select="@name"/> 
</td> 
<td> 
<xsl:value-of select="@edition"/> 
</td> 
</tr> 
</xsl:template> 
</xsl:stylesheet> 


fi FH XSLT 到 ParameterExample.htm 或 者 使 用 LINQ 到 ParameterExample LINQ.htm 的 第 
一 次 转换 的 输出 如 图 10-2 所 示 。 





Brought to you by Hero Comics Inventory 
on Sunday, July 19, 2015 12:54:51 PM 





[Heroes Edition 
The Uncanny X-Men 2 
The Fantastic Four 5 
[The Amazing Spider-Man |1 
[Superman 3 0 
‘Batman 4 











10-2. 第 一 组 参数 的 输出 


使 用 XSLT 到 ParameterExample2.htm 或 者 使 用 LINQ 到 ParameterExample2_LINQ.htm 的 
第 二 次 转换 的 输出 如 图 10-3 所 示 。 
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& 10-3: 第 二 组 参数 的 输出 


10.10.3 ”讨论 


两 种 方法 都 允许 你 模板 化 代码 并 提供 参数 以 修改 输出 。 使 用 LINQ to XML 方法 ， 代 码 都 
是 .NET 的 ,而 .NET 分析 工具 可 用 于 度量 转换 的 影响 。 使 用 代码 的 声明 式 风格 传达 的 意图 
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比 必须 转 到 外 部 XSLT 文件 更 明显 。 如 果 你 不 了 解 XSLT， 那 么 就 不 必 学 习 它 ， 因 为 你 现 
在 就 可 以 用 代码 完成 这 项 工作 。 


如 果 你 已 经 了 解 XSLT， 那 么 可 以 继续 充分 利用 它 。 向 XSLT 样式 表 传 递 信息 的 能 力 在 通 
过 XSLT 转换 设计 报告 或 用 户 界面 时 允许 更 大 程度 的 灵活 性 。 这 种 能 力 有 助 于 根据 你 能 想 
到 的 任何 标准 来 定制 输出 ， 因 为 传人 的 数据 完全 由 程序 来 控制 。 一 旦 你 掌握 了 使 用 带 参 数 
HJ XSLT 的 方法 ， 那 么 一 种 全 新 的 自 定义 级 别 就 成 为 了 可 能 。 一 个 额外 的 好 处 是 ， 它 在 不 
同 环境 之 间 是 可 移植 的 。 
































10.10.4 ”参考 


MSDN 文档 中 的 “使 用 LINQ 进行 数据 转换 ”“XsLtArgumentList 类 ”和 “XsLtSettings 
类 ”主题 。 
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kt 
W> nu 


11.0 简介 

在 NET 中 运行 代码 的 安全 性 围绕 代码 访问 安全 性 (code access security, CAS) 展开 。 
CAS 基于 程序 集 的 来 源 和 程序 集 自身 的 特性 决定 其 可 信赖 性 ， 比 如 程序 集 的 散 列 值 。 例 
如 ， 计 算 机 本 身 安装 的 代码 要 比 从 网 上 下 载 的 代码 更 加 安全 。 在 允许 代码 运行 之 前 ， 运 行 
时 同样 会 验证 程序 集 的 元 数据 及 其 类 型 安全 性 。 
在 .NET Framework 中 有 很 多 种 编写 安全 代码 和 保护 数据 的 机 制 。 在 本 章 中 ， 我 们 将 探讨 
以 下 主题 : 控制 对 类 型 的 访问 ， 加 密 和 解密 ， 用 于 安全 的 随机 数 ， 安 全 存储 数据 ， 以 及 使 
用 编程 方式 和 声明 方式 安全 等 。 


11.1 加 密 和 解密 字符 串 


11.1.1 问题 


你 有 一 个 希望 加 密 或 解密 的 字符 串 (或 许 是 密码 或 软件 密 钥 ) ， 该 字符 串 会 以 某 种 形式 存 
储 ， 例 如 存储 在 文件 或 注册 表 中 。 你 希望 能 将 这 些 字符 串 保 密 ， 从 而 使 其 他 用 户 无 法 得 到 


这 些 信息 。 


11.1.2 解决 方案 

给 字符 串 加 密 将 有 助 于 防止 用 户 读 取 和 破译 这 些 信 息 。 例 11-1 中 所 示 的 CryptoString 类 
包含 两 个 静态 方法 ， 用 来 加 密 和 解密 一 个 字符 串 ， 以 及 两 个 静态 属性 ， 在 加 密 之 后 获得 生 
成 的 密 钥 和 初始 向 量 (initialization vector，IV;， 是 用 作 加 密 数据 起 点 的 一 个 随机 数 ) 。 
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例 11-1; CryptoString 类 
using System; 
using System.Security.Cryptography; 


public sealed class CryptoString 
{ 
private CryptoString() {} 


private static byte[] savedKey = null; 
private static byte[] savedIV = null; 


public static byte[] Key { get; set; } 
public static byte[] IV { get; set; } 


private static void RdGenerateSecretKey(RijndaelManaged rdProvider) 


{ 
if (savedKey == null) 
{ 
rdProvider.KeySize = 256; 
rdProvider.GenerateKey(); 
savedKey = rdProvider.Key; 
} 
} 
private static void RdGenerateSecretInitVector(RijndaelManaged rdProvider) 
{ 
if (savedIV == null) 
{ 
rdProvider.GenerateIV(); 
savedIV - rdProvider.IV; 
} 
} 


public static string Encrypt(string originalStr) 

{ 
// 对 将 要 存储 在 内 存 中 的 数据 字符 串 进行 加 密 
byte[] originalStrAsBytes = Encoding.ASCII.GetBytes(originalStr); 
byte[] originalBytes = {}; 








// 创建 MemoryStream 以 包含 输出 
using (MemoryStream memStream = new 
MemoryStream(originalStrAsBytes.Length) ) 
{ 
using (RijndaelManaged rijndael = new RijndaelManaged()) 
t 
// 生成 并 保存 密 钥 和 初始 向 量 
RdGenerateSecretKey(rijndael); 
RdGenerateSecretInitVector(rijndael); 





if (savedKey -- null || savedIV -- null) 
{ 


throw (new NullReferenceException( 
"savedKey and savedIV must be non-null.")); 








// 创建 加 密 器 和 流 对 象 

using (ICryptoTransform rdTransform = 
rijndael.CreateEncryptor((byte[ ])savedKey. 
Clone(),(byte[])savedIV.Clone())) 


using (CryptoStream cryptoStream = new CryptoStream(memStream, 
rdTransform, CryptoStreamMode.Write) ) 
{ 


// 将 加 密 后 的 数据 写 入 MemoryStream 
cryptoStream.Write(originalStrAsBytes, 0, 
originalStrAsBytes.Length); 
cryptoStream.FlushFinalBlock(); 
originalBytes - memStream.ToArray(); 


j 
j 
// 转换 加 密 过 的 字符 串 


string encryptedStr = Convert.ToBase64String(originalBytes) ; 
return (encryptedStr); 





} 


public static string Decrypt(string encryptedStr) 

{ 
// 逆转 换 加 密 字符 串 
byte[] encryptedStrAsBytes = Convert.FromBase64String(encryptedStr); 
byte[] initialText = new Byte[encryptedStrAsBytes.Length]; 


using (RijndaelManaged rijndael = new RijndaelManaged()) 








{ 

using (MemoryStream memStream = new MemoryStream(encryptedStrAsBytes)) 
{ 

if (savedKey == null || savedIV == null) 

{ 

throw (new NullReferenceException( 
"savedKey and savedIV must be non-null.")); 

} 

// 创建 解密 器 和 流 对 象 

using (ICryptoTransform rdTransform = 

rijndael.CreateDecryptor((byte[])savedKey.Clone(), 
(byte[ ])savedIV.Clone())) 
using (CryptoStream cryptoStream - new CryptoStream(memStream, 
rdTransform, CryptoStreamMode.Read)) 
// 将 解密 过 的 字符 串 作为 byte[] 读 取 
cryptoStream.Read(initialText, 0, initialText.Length); 
} 

} 

} 
} 


// 将 byte[] 转 换 为 string 
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string decryptedStr = Encoding.ASCII.GetString(initialText) ; 
return (decryptedStr); 
} 
j 


11.1.3. 讨论 

CryptoString 类 除了 私有 实例 构造 函数 外 只 包含 静态 成 员 ， 用 来 阻止 任何 人 直接 从 该 类 创 
建 对 象 。 

该 类 使 用 Rijndael 算法 (Rijndael algorithm) 对 字符 串 进行 加 密 和 解密 。 该 算法 可 在 
System.Security.Cryptography.RijndaelManaged 类 中 找到 。 该 算法 要 求 一 个 密 钥 和 一 个 初 
始 癌 量 ， 两 者 都 是 byte 数组 。 通 过 调用 RijndaelManaged 类 上 的 GenerateKey 方法 可 以 生 
成 一 个 随机 密 钥 。 该 方法 不 接受 参数 ， 返 回 void。 生 成 的 密 钥 被 放 在 RijndaelManaged 类 
的 Key 属性 中 。GenerateIV 方法 生成 一 个 随机 初始 向 量 ， 放 在 RijndaelManaged 类 的 IV 属 
性 中 。 

Key 和 IV 属性 中 的 byte 数组 必须 存储 起 来 以 便 随 后 使 用 ， 并 且 不 能 进行 更 改 。 这 是 由 私 
有 密 钥 类 的 特性 决定 的 ， 例 如 RijndaelManaged, Key 和 IV 值 必 须 由 加 密 和 解密 程序 使 用 ， 
以 成 功 地 加 密 和 解密 数据 。 

SavedKey 和 SavedIV 私有 静态 字段 分 别 包 含 密 钥 和 初始 向 量 。 加 密 和 解密 方法 都 使 用 密 铀 
来 加 密 和 解密 数据 。 这 就 是 这 两 个 值 作为 公共 属性 的 原因 ， 因 此 它们 可 以 存储 在 其 他 安全 
地 方 以 备 之 后 使 用 。 这 意味 着 任何 由 该 对 象 加 密 的 字符 串 必 须 由 该 对 象 进行 解密 。 初 始 向 
量 使 得 从 加 密 字 符 串 中 推演 出 密 钥 更 加 困难 。 为 了 实现 这 一 点 ， 初 始 向 量 使 两 个 同样 的 加 
密 字 符 串 (使 用 相同 的 密 钥 加 密 ) 的 加 密 形式 看 起 来 有 巨大 差异 。 

CryptoString 类 中 的 两 个 方法 RdGenerateSecretKey 和 RdGenerateSecretInitVector 用 于 
在 密 钥 和 初始 向 量 皆 不 存在 时 生成 它们 。RdGenerateSecretkey 方法 生成 密 钥 ， 存 放 在 
SavedKey 字段 中 。 同 样 ，RdaenerateSecretInitvector 生成 初始 向 量 ， 存 放 在 SavedIV ^E 
段 中 。 仅 为 该 类 生成 了 唯一 的 密 钥 和 IV。 这 使 得 加 密 和 解密 程序 能 够 一 直 访 问 相 同 的 密 铀 
fU IV 信息 。 
CryptoString 类 的 Encrypt 和 Decrypt 方法 执行 加 密 和 解密 一 个 字符 串 的 实际 工作 。 
Encrypt 方法 接受 一 个 希望 加 密 的 字符 串 并 返回 一 个 加 密 的 字符 串 。 下 列 代码 调用 该 方法 
并 传递 一 个 要 加 密 的 字符 串 。 


string encryptedString = CryptoString.Encrypt("MyPassword"); 
Console.WriteLine($"encryptedString: {encryptedString}"); 





































































































// 获得 所 使 用 的 密 钥 和 IV, 以 便 稍 后 可 以 解密 
byte [] key = CryptoString.Key; 
byte [] IV = CryptoString.IV; 


一 旦 字符 串 被 加 密 ， 就 存储 密 钥 和 IV 用 于 以 后 进行 解密 。 该 方法 显示 的 内 容 如 下 所 示 。 
encryptedString: NmmKqB04iPT+BDxgLVwzgQ== 


要 注意 ， 你 的 输出 可 能 会 有 所 不 同 ， 因 为 你 将 会 使 用 一 个 不 同 的 密 钥 和 IV 值 。 下 列 代码 
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设置 用 于 加 密 字符 串 的 密 钥 和 IV， 然 后 调用 Decrypt 方法 解密 前 面 加密 过 的 字符 串 。 


CryptoString.Key = key; 

CryptoString.IV - IV; 

string decryptedString - CryptoString.Decrypt(encryptedString); 
Console.WriteLine($"decryptedString: {decryptedString}"); 


该 方法 显示 的 内 容 如 下 所 示 。 


decryptedString: MyPassword 


在 要 加 密 的 字符 串 中 使 用 诸如 Nr. Nn, VAn 或 \t 等 转 义 序列 看 起 来 不 会 出 现 什 么 问题 。 
此 外 ， 不 管 带 不 带 转 义 字符 ， 使 用 加 引号 的 字符 串 文本 都 不 会 出 现 问 题 ， 如 下 所 示 。 


@"MyPassword" 




















11.1.4 参考 


范例 11.2 (Bl 11.2 节 ) ; MSDN 文档 中 的 “System.Cryptography 命名 空间 ”“MemoryStream 
类 ”“ICryptoTransform 接口 ”和 “RijndaelManaged 类 ”主题 。 


11.2 ”加 密 和 解密 文件 


11.2.1 问题 


你 有 一 些 敏感 信息 ， 必 须 在 将 其 写 入 一 个 可 能 位 于 不 安全 区 域 的 文件 之 前 进行 加 密 。 该 信 
息 在 被 读 取 回应 用 程序 之 前 也 必须 进行 解密 。 


11.2.2 解决 方案 

使 用 多 种 加 密 提供 者 将 数据 以 加 密 格式 写 和 文件。 下 面 的 类 可 以 完成 这 项 工作 ， 它 有 一 个 
构造 函数 ， 接 受 System.Security.Cryptography.SymmetricAlgorithm 类 的 一 个 实例 和 文件 
BRE, SymmetricAlgorithm 类 是 NET 中 用 于 加 密 提供 者 的 抽象 基 类 ， 因 此 你 能 够 确保 该 
类 可 以 被 扩展 并 履 盖 到 全 部 的 密码 算法 。 该 示例 实现 了 对 TripleDES 和 Rijndael 的 支持 。 


该 解决 方案 需要 使 用 以 下 命名 空间 。 


using System; 

using System.Text; 

using System.IO; 

using System.Security.Cryptography; 


SecretFile 类 (参考 例 11-2) 可 用 于 TripleDES， 如 下 所 示 。 


// 使 用 TripLeDES 
using (TripleDESCryptoServiceProvider tdes = new 
TripleDESCryptoServiceProvider()) 



























































( 


SecretFile secretTDESFile - new SecretFile(tdes,"tdestext.secret"); 
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} 


string encrypt = "My TDES Secret Data!"; 
Console.WriteLine($"Writing secret data: {encrypt}"); 
secretTDESFile. SaveSensitiveData(encrypt) ; 


// 保存 到 存储 中 以 读 取 文 件 
byte [] key = secretTDESFile.Key; 
byte [] IV = secretTDESFile. IV; 





string decrypt = secretTDESFile.ReadSensitiveData(); 
Console.WriteLine($"Read secret data: {decrypt}"); 








要 将 Rijndael 用 于 SecretFile, RER FERRER tie eB e D BIT nT , 
// 使 用 Rijndael 


using (RijndaelManaged rdProvider = new RijndaelManaged()) 


{ 


} 














SecretFile secretRDFile = new SecretFile(rdProvider,"rdtext.secret"); 
string encrypt = "My Rijndael Secret Data!"; 


Console.WriteLine($"Writing secret data: {encrypt}"); 
secretRDFile.SaveSensitiveData(encrypt); 

// 保存 到 存储 中 以 读 取 文 件 

byte [] key = secretRDFile.Key; 

byte [] IV = secretRDFile.IV; 





string decrypt = secretRDFile.ReadSensitiveData(); 
Console.WriteLine($"Read secret data: {decrypt}"); 


例 11-2 展示 了 SecretFile 的 实现 。 
例 11-2: SecretFile 类 


public class SecretFile 


{ 


private byte[] savedKey = null; 

private byte[] savedIV = null; 

private SymmetricAlgorithm symmetricAlgorithm; 
string path; 


public byte[] Key { get; set; } 
public byte[] IV { get; set; } 


public SecretFile(SymmetricAlgorithm algorithm, string fileName) 


{ 
symmetricalgorithm; 
path = fileName; 

} 


public void SaveSensitiveData(string sensitiveData) 


{ 





pay 


// 将 数据 字符 串 编码 以 存储 到 加 密 文件 


byte[] encodedData = Encoding.Unicode.GetBytes(sensitiveData); 








// 创建 文件 流 和 加 密 服务 提供 者 对 象 

using (FileStream fileStream = new FileStream(path, 
FileMode.Create, 
FileAccess.Write) ) 


// 生成 并 保存 密 钥 和 初始 向 量 
GenerateSecretKey(); 
GenerateSecretInitVector(); 





// 创建 加 密 转 换 和 流 对 象 
using (ICryptoTransform transform = 
symmetricAlgorithm.CreateEncryptor(savedKey, 
savedIV)) 


using (CryptoStream cryptoStream - 
new CryptoStream(fileStream, transform, 
CryptoStreamMode.Write) ) 


// 将 加 密 后 的 数据 写 入 文件 


cryptoStream.Write(encodedData, 0, encodedData.Length); 


} 


public string ReadSensitiveData() 


t 


string decrypted = ""; 





// 创建 文件 流 以 回 读 加 密 文件 

using (FileStream fileStream = new FileStream(path, 
FileMode.Open, 
FileAccess.Read) ) 





o 











// 输出 加 密 文件 的 内 容 
using (BinaryReader binReader = new BinaryReader(fileStream) ) 
{ 
Console.WriteLine("---------- Encrypted Data --------- mys 
int count = (Convert. ToInt32(binReader .BaseStream.Length)); 
byte [] bytes = binReader.ReadBytes(count) ; 
char [] array = Encoding.Unicode.GetChars(bytes) ; 
string encdata = new string(array); 
Console.WriteLine(encdata) ; 
Console.WriteLine($"---------- Encrypted Data --------- 
{Environment .NewLine}"); 


// 重 置 文件 流 
fileStream.Seek(0,SeekOrigin.Begin); 





// 创建 解密 器 

using (ICryptoTransform transform = 
symmetricAlgorithm.CreateDecryptor(savedKey, savedIV)) 

{ 


using (CryptoStream cryptoStream = new CryptoStream(fileStream, 
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transform, 
CryptoStreamMode.Read)) 





{ 
// 输出 已 解密 文件 的 内 容 
using (StreamReader srDecrypted = 
new StreamReader(cryptoStream, new UnicodeEncoding())) 
{ 
Console.WriteLine('"---------- Decrypted Data --------- "ys 
decrypted = srDecrypted.ReadToEnd(); 
Console.WriteLine(decrypted) ; 
Console.WriteLine($"---------- Decrypted Data --------- 
{Environment.NewLine}"); 
} 
} 
} 
} 
} 
return decrypted; 
} 
private void GenerateSecretKey() 
{ 
if (null != (symmetricAlgorithm as TripleDESCryptoServiceProvider ) ) 
{ 
TripleDESCryptoServiceProvider tdes; 
tdes = symmetricAlgorithm as TripleDESCryptoServiceProvider ; 
tdes.KeySize = 192; // 最 大 的 密 钥 大 小 
tdes.GenerateKey(); 
savedKey - tdes.Key; 
} 
else if (null != (symmetricAlgorithm as RijndaelManaged) ) 
{ 
RijndaelManaged rdProvider; 
rdProvider = symmetricAlgorithm as RijndaelManaged; 
rdProvider.KeySize = 256; // 最 大 的 密 钥 大 小 
rdProvider.GenerateKey(); 
savedKey = rdProvider.Key; 
} 
} 


private void GenerateSecretInitVector() 


if (null != (symmetricAlgorithm as TripleDESCryptoServiceProvider)) 
{ 
TripleDESCryptoServiceProvider tdes; 
tdes = symmetricAlgorithm as TripleDESCryptoServiceProvider ; 
tdes.GenerateIV(); 
savedIV - tdes.IV; 
} 
else if (null != (symmetricAlgorithm as RijndaelManaged) ) 
{ 
RijndaelManaged rdProvider; 
rdProvider = symmetricAlgorithm as RijndaelManaged; 
rdProvider.GenerateIV(); 





savedIV = rdProvider.IV; 
} 
} 


如 果 将 SaveSensitiveData 方法 用 于 把 下 列 文本 存储 到 文件 中 : 


This is a test 
This is sensitive data! 


IBA, ReadSensitiveData 方法 将 显示 来 自 相 同文 件 的 下 列 信息 : 


Tee Encrypted Data -------- 
22222222222222222?22?22?22?2??2???2???????? 





T Decrypted Data --------- 
This is a test 

This is sensitive data! 

---------- Decrypted Data --------- 


11.2.3 讨论 

T 数据 对 很 多 应 用 程序 都 是 很 必要 的 ， 特 别 是 那些 将 信息 存储 在 易 访 问 位 置 的 应 用 程 
序 。 一 旦 数据 被 加 密 ， 就 需要 一 种 解密 方案 将 数据 重新 恢复 成 未 加 密 的 形式 而 不 丢失 任何 

信息 。 

本 范例 中 使 用 的 加 密 方案 是 TripleDES 和 Rijndael。 使 用 TripleDES 有 以 下 几 个 原因 。 


。 TripleDES 使 用 对 称 加 密 ， 意 味 着 使 用 一 个 单独 的 私 钥 加 密 和 解密 数据 。 这 一 过 程 允 许 
更 快 的 加 密 和 解密 ， 特 别 是 当 数据 流 变 得 更 大 时 。 

。 TripleDES 加 密 算法 的 破解 比 老 的 DES 加 密 术 要 难得 多 ， 被 广泛 认为 是 高 强度 的 。 

。 如 果 你 希望 另 一 种 类 型 的 加 密 ， 那 么 可 使 用 从 SymmetricAlgorithm 类 派生 出 的 任意 提供 
者 轻松 地 转换 该 范例 。 

。 TripleDES 目前 在 业内 得 到 了 广泛 的 应 用 


TripleDES 的 主要 缺陷 在 于 发 送 方 和 接收 方 必 须 使 用 相同 的 密 钥 和 初始 向 量 (IV). 对 数据 
进行 成 功 的 加 密 和 解密 。 如 果 你 希望 拥有 更 安全 的 加 密 方案 ， 那 么 可 以 使 用 Rijndael 方案 。 
该 加 密 方案 的 类 型 被 认为 是 一 种 可 靠 的 加 密 方案 ， 因 为 它 的 运行 速度 快 并 且 可 以 使 用 比 
TripleDES 更 大 的 密 钥 。 但 是 ， 它 仍 是 一 种 对 称 密 "m 统 ， 这 意味 着 它 依 赖 共 享 密 钥 。 对 
于 使 用 共享 公 钥 并 且 带 有 不 在 参与 方 之 间 共 享 的 私 钥 的 密码 系统 ， 可 以 使 用 非 对 称 密码 系 
统 ， 如 RSA 和 DSA。 


11.2.4 ”参考 


MSDN 文档 中 和 的 “SymmetricAlgorithm 类 " *TripleDESCryptoServiceProvider 类 ”和 
"RijndaelManaged 类 ”主题 。 
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13 ”清理 密码 算法 信息 


11.3.1 问题 


你 要 使 用 FCL 中 的 密码 算法 类 来 加 密 或 解密 数据 。 为 此 ， 你 希望 确保 数据 (例如 种 子 值 或 
密 钥 ) 留 在 内 存 中 的 时 间 不 长 于 正在 使 用 的 密码 类 。 黑 客 有 时 会 在 内 存 中 发 现 该 信息 ， 并 
使 用 它 破译 你 的 加 密 ， 更 糟糕 的 是 ， 黑 客 可 能 破译 用 户 的 密码 、 修 改 数据 ， 然 后 重新 加 密 

















数据 ， 迫 使 你 的 应 用 程序 使 用 被 破坏 过 的 数据 而 非 合法 数据 。 


11.3.2 ”解决 方案 


为 了 清理 密 钥 和 初始 向 量 (或 种 子 值 )， 需 要 调用 从 你 使 用 的 任意 SymmetricAlgorithm 或 
AsymmetricAlgorithm 派生 出 的 类 上 的 Clear 方法 。Clear 重新 初始 化 密 钥 和 IV 属性 ， 防 止 











在 内 存 中 发 现 它们 。 在 存储 了 密 钥 和 IV 之 后 调用 它 ， 从 而 可 以 在 随后 进行 解密 。 
展示 了 如 何 加 密 一 个 字符 串 ， 随 后 立即 清理 ， 尽 可 能 降低 潜在 攻击 者 的 攻击 机 会 。 





























例 11-3: 清理 密码 算法 信息 
Using System; 
using System.Text; 
using System.IO; 
using System.Security.Cryptography; 





public static void CleanUpCrypto() 
{ 


string originalStr = "SuperSecret information"; 


// 将 数据 字符 串 编码 以 存储 在 内 存 中 





byte[] originalStrAsBytes = Encoding.ASCII.GetBytes(originalStr); 








// 创建 MemoryStream 以 包含 输出 


MemoryStream memStream = new MemoryStream(originalStrAsBytes.Length) ; 


RijndaelManaged rijndael = new RijndaelManaged(); 





// 生成 密 钥 和 初始 向 量 
rijndael.KeySize = 256; 
rijndael.GenerateKey(); 
rijndael.GenerateIV(); 














// 保存 密 钥 和 IV 以 用 于 之 后 的 解密 
byte [] key = rijndael.Key; 
byte [] IV = rijndael.IV; 








// 创建 加 密 器 和 流 对 象 


ICryptoTransform transform = rijndael.CreateEncryptor(rijndael.Key, 


rijndael.IV); 


CryptoStream cryptoStream = new CryptoStream(memStream, transform, 


CryptoStreamMode.Write); 


// 将 加 密 过 的 数据 写 入 到 MemoryStream 


cryptoStream.Write(originalStrAsBytes, 0, originalStrAsBytes.Length); 


cryptoStream.FlushFinalBlock(); 





例 11-3 





} 


你 还 可 以 通过 使 用 using AE T EAE BE (8) 8 


// 完成 之 后 立即 释放 所 有 资源 

// 以 避免 在 内 存 中 保持 任何 信息 
memStream.Close(); 

cryptoStream.Close(); 
transform.Dispose(); 

// clear 语 句 重 成 生成 密 钥 和 初始 向 量 

// 因此 留 在 内 存 中 的 不 再 是 你 用 于 加 密 的 信息 
rijndael.Clear(); 












































下 列 代 码 块 展示 了 如 何 使 用 using 语句 。 


public static void CleanUpCryptoWithUsing() 


( 


string originalStr = "SuperSecret information"; 
// 将 数据 字符 串 编码 以 存储 在 内 存 
byte[] originalStrAsBytes = Encoding.ASCII.GetBytes(originalStr); 
byte[] originalBytes = { }; 





g 











// 创建 MemoryStream 以 包含 输出 


ple, RUFIE Close 方法 进行 调用 。 


using (MemoryStream memStream = new MemoryStream(originalStrAsBytes.Length) ) 


{ 
using (RijndaelManaged rijndael = new RijndaelManaged()) 
{ 
// 生成 密 钥 和 初始 向 量 
rijndael.KeySize = 256; 
rijndael.GenerateKey(); 
rijndael.GenerateIV(); 




















// 保存 密 钥 和 IV 以 用 于 之 后 的 解密 
byte[] key = rijndael.Key; 
byte[] IV = rijndael.IV; 


// 创建 加 密 器 和 流 对 象 
using (ICryptoTransform transform = 
rijndael.CreateEncryptor(rijndael.Key, rijndael.IV)) 





{ 
using (CryptoStream cryptoStream = new 
CryptoStream(memStream, transform, 
CryptoStreamMode.Write) ) 


// 将 加 密 过 的 数据 写 和 MemoryStream 

cryptoStream.Write(originalStrAsBytes, 0, 
originalStrAsBytes.Length); 

cryptoStream.FlushFinalBlock(); 
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11.3.3 讨论 

为 确保 数据 安全 ， 你 需要 尽快 关闭 MemoryStream Ail CryptoStream 对 象 ， 并 调用 
ICryptoTransform 上 的 Dispose， 清 理 加 密 中 使 用 的 所 有 资源 。using 语句 令 这 一 过 程 变 得 
简单 ， 令 你 的 代码 更 易 阅读 ， 并 且 减 少 了 编程 错误 。 











11.3.4 ”参考 


MSDN 文档 中 的 “SymmetricAlgorithm.Clear 方法 ”和 “AsymmetricAlgorithm.Clear 方法 ” 
主题 。 


11.4 ”避免 字符 串 在 传输 或 静止 时 被 自 改 


11.4.1 问题 


你 需要 将 一 些 文本 跨 网 络 发 送 到 另 一 台 机 器 进行 处 理 或 者 将 其 放置 在 存储 介质 中 以 便于 以 
后 检索 。 你 需要 验证 此 文本 仍 未 被 修改 、 未 被 干预 ， 并且 未 损坏 。 


11.4.2 ”解决 方案 

从 字符 串 计 算 散 列 值 ， 将 散 列 值 数字 化 签名 ， 并 向 接收 方 同时 发 送 字符 串 和 它 的 数字 签名 
( 公 钥 也 将 提供 给 接收 方 )。 一 旦 目标 接收 到 此 信息 ， 就 可 以 通过 验证 不 能 被 伪造 或 修改 的 
数字 签名 ， 来 确定 该 字符 串 是 否 是 最 初 发 送 的 那 一 个 。 

在 探究 如 何 工作 的 细节 之 前 ， 首 先 来 看 一 下 用 于 对 字符 串 数 据 进行 数字 签名 以 及 反 过 来 用 
相同 的 数字 签名 确认 此 字符 串 未 发 生 更 改 的 代码 。 在 例 11-4 中 ，AntiTamper 类 包含 两 个 方 
ik, SignString 和 VerifySignedString， 它 们 分 别 执行 相应 的 职责 。SignString 方法 接受 
明文 字符 串 ， 并 且 从 它 生成 数字 签名 。Verifysignedstring 方法 由 接收 到 字符 串 的 代码 来 
使 用 ， 以 确定 在 接收 之 前 该 字符 串 是 否 以 任何 方式 修改 过 。 

例 11-4; AntiTamper 类 


public class AntiTamper 


{ 
static private readonly int RSA_KEY_SIZE = 2048; 





























public static byte[] SignString(string clearText, out string rsaPublicKey) 


{ 
byte[] signature = null; 
rsaPublicKey = null; 


byte[] encodedClearText = Encoding.Unicode.GetBytes(clearText); 


using (SHA512CryptoServiceProvider sha512 - 
new SHA512CryptoServiceProvider()) 
{ 


using (RSACryptoServiceProvider rsa = 
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new RSACryptoServiceProvider(RSA KEY SIZE)) 
signature - rsa.SignData(encodedClearText, sha512); 
rsaPublicKey - rsa.ToXmlString(false); 


} 


return signature; 


} 


public static bool VerifySignedString(string clearText, byte[] signature, 
string rsaPublicKey) 


{ 
bool verified = false; 
byte[] encodedClearText = Encoding.Unicode.GetBytes(clearText) ; 


using (SHA512CryptoServiceProvider sha512 = 
new SHA512CryptoServiceProvider()) 
{ 
using (RSACryptoServiceProvider rsa = 
new RSACryptoServiceProvider(RSA KEY SIZE)) 
{ 


rsa.FromXmlString(rsaPublicKey); 
verified - rsa.VerifyData(encodedClearText, sha512, signature); 


j 


return verified; 


VerifyStringIntegrity 方法 演示 如 何 使 用 AntiTamper 类 进行 签名 和 验证 字符 串 。 
VerifyStringIntegrity 方法 首先 调用 SendData 方法 。 此 方法 封装 了 存在 于 发 送 方 的 代 
码 ， 但 你 将 需要 添加 真实 地 向 接收 方 发 送 完 整 消息 的 代码 。 发 送 消 息 之 前 ， 此 方法 从 字符 
串 数 据 生成 我 们 想 要 用 来 保护 字符 串 免 受 自 改 的 数字 签名 。 AntiTamper. 
SignString 方法 生成 数字 签名 。 此 方法 以 byte[] 返回 一 个 数字 签名 ， 并 且 通 过 out 参数 返 
回 RSA 公 钥 信息 。 验 证 方法 ReceiveData 需要 此 RSA 公 钥 信息 。 


是 理解 接收 方 需要 以 下 三 个 项 目 : 原始 字符 串 数 据 ， 它 的 数字 签名 ， 以 
及 公 钥 。 字 符 串 数据 和 签名 可 以 在 同一 条 消息 中 发 送 ， 然 而 ， 公 钥 可 以 连同 
消息 一 起 发 送 ， 也 可 以 通过 单独 的 通道 进行 分 发 。 这 个 单独 的 通道 可 以 是 以 
下 几 种 机 制 之 一 : 经 过 签名 和 加 密 的 电子 邮件 ， 安 全 的 FTP 服务 器 ， 由 信任 
的 第 三 方 权 威 机 构 签名 的 X.509 证 书 ， 简 单 公 钥 基 础 架构 (SPKI) 或 者 使 用 
Pretty Good Privacy (PGP) 签名 和 加 密 公 钥 以 证 明 其 来 源 于 预期 中 的 一 方 。 
无 论 你 使 用 何 种 机 制 来 分 发 公 钥 ， 至 关 重 要 的 是 接收 方 信任 此 公 钥 确实 来 自 
正确 的 一 方 。 
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第 二 个 方法 Receivedata 接收 字符 串 数据 、 生 成 的 数字 签名 和 RSA 公 钥 信 息 ， 使 用 数字 答 
名 来 验证 收 到 的 字符 串 数据 。 此 方法 封装 了 存在 于 接收 方 一 方 的 代码 ， 但 你 将 需要 添加 真 
实地 从 发 送 方 接收 完整 消息 的 代码 。 如 果 数 字 签 名 确定 证 明了 字 签 串 数据 未 被 算 改 ， 则 返 
回 布尔 值 true， 否 则 返回 fatse， 指 示 访 字符 串 数 据 已 被 修改 或 算 改 ，。 


public static void VerifyStringIntegrity() 
























































{ 
string originalString = "This is the string that we'll be testing."; 
// 从 我 们 需要 保护 的 原始 字符 串 值 中 创建 一 个 散 列 值 ， 
// 并 对 散 列 值 签名 
string rsaPublicKey; 
byte[] signature - SendData(originalString, out rsaPublicKey); 
// 取消 下 行 代码 的 注释 以 快速 测试 处 理 一 个 自 改 过 的 字符 串 
// originalString += "a"; 
// 取消 下 行 代码 的 注释 以 快速 测试 处 理 一 个 算 改 过 的 签名 
// signature[1] = 100; 
// 现在 ,确认 字符 串 未 被 损坏 ,未 被 自 改 
if (ReceiveData(originalString, signature, rsaPublicKey)) 
{ 
Console.WriteLine( 
"The original string was NOT corrupted or tampered with."); 
} 
else 
{ 
Console.WriteLine( 
"ALERT: The original string was corrupted and/or tampered with."); 
} 
} 
private static byte[] SendData(string originalString, out string rsaPublicKey) 
{ 
// 对 字符 串 数据 进行 数字 签名 
byte[] signature = AntiTamper.SignString(originalString, out rsaPublicKey); 
// 将 数据 发 送 到 目标 
return signature; 
} 


private static bool ReceiveData(string originalString, byte[] signature, 
string rsaPublicKey) 
// 从 发 送 方 接收 到 数据 
// 验证 数字 签名 


return (AntiTamper.VerifySignedString(originalString, signature, 
rsaPublicKey)); 





当 字符 串 未 被 破坏 时 ， 该 方法 的 输出 如 下 所 示 。 





The original string was NOT corrupted or tampered with. 
FFF ESI, AAKA hA PR. 
ALERT: The original string was corrupted and/or tampered with. 
若 实 际 查 看 这 一 情况 ， 只 需要 取消 VerifystringIntegrity 方法 中 的 以 下 两 个 注释 行 之 一 : 
// 取消 下 行 代码 的 注释 以 快速 测试 处 理 一 个 自 改 过 的 字符 串 


originalString += "a"; 


HE 




















以 及 : 


// 取消 下 行 代码 的 注释 以 快速 测试 处 理 一 个 算 改 过 的 签名 
signature[1] = 100; 

















11.4.3 讨论 


散 列 值 对 于 确定 数据 在 静止 或 传输 时 是 否 被 修改 是 非常 有 用 的 。 首 先 从 想 要 保护 的 数据 中 
计算 出 一 个 散 列 值 [其 至 是 一 个 校 验 和 或 者 循环 元 余 检 查 (CRC) 值 ]。 然 后 将 此 散 列 值 
与 数据 一 起 发 送 到 接收 方 。 接 收 方 基于 收 到 的 数据 重新 计算 散 列 值 。 如 果 新 的 散 列 值 与 收 
到 的 散 列 值 匹配 ， 则 数据 未 被 更 改 ， 否 则 说 明 数 据 在 某 种 程度 上 已 被 修改 或 损坏 。 








双方 协定 使 用 同一 个 散 列 算法 是 至 关 重 要 的 。SHA-256 和 SHA-512 算法 都 
是 一 个 不 错 的 安全 选择 ， 同 时 也 是 行业 标准 。 








虽然 这 个 散 列 技术 在 标识 数据 已 被 损坏 或 被 意外 修改 方面 工作 良好 ， 但 它 无 法 防止 攻击 者 
偷偷 尝试 修改 数据 以 获得 对 系统 的 访问 或 者 散布 假 信息 以 企图 敲诈 或 勒索 。 如 果 只 有 一 个 
散 列 值 用 来 保护 数据 ， 攻 击 者 可 以 截获 数据 (使 用 中 间 人 攻击 )， 修 改 数据 ， 然 后 使 用 修 
改 后 的 数据 重新 生成 一 个 新 的 散 列 。 之 后 在 发 送 到 预期 接收 方 之 前 使 用 新 的 散 列 替换 旧 的 
散 列 值 。 接 收 方 无 法 得 知 数据 已 被 算 改 ， 因 为 从 接收 方 的 角度 来 看 ， 接 收 方 生成 的 散 列 值 
与 接收 到 的 散 列 值 是 相同 的 。 若 要 防止 这 些 类 型 的 攻击 ， 需 要 更 健壮 的 系统 。 这 就 是 数字 
签名 发 挥 作用 之 处 。 

数字 签名 是 通过 一 种 非 对 称 公 钥 加 密 算法 生成 的 。 这 意味 着 有 两 把 密 钥 。 第 一 把 是 可 以 分 
发 给 所 有 将 会 收 到 已 签名 数据 的 协作 方 的 公 钥 。 此 公 钥 将 用 于 验证 所 接收 的 数据 的 数字 签 
名 。 第 二 把 是 必须 安全 地 存放 在 数据 发 送 方 的 私 钥 。 私 钥 仅 用 于 将 数据 发 送 给 接收 方 之 前 
数据 进行 初始 签名 。 公 钥 和 私 钥 一 起 工作 ， 一 个 用 来 对 数据 进行 签名 ， 男 一 个 不 仅 证 明 签 
名 来 自 预 期 发 送 方 ， 也 保证 使 用 该 签名 签名 过 的 数据 未 被 算 改 、 修 改 或 损坏 。 


如 有 果 私 钥 被 盗 ， 攻 击 者 将 能 够 对 数据 进行 数字 签名 ， 假 装 他 是 数据 的 合法 发 
送 方 。 永 远 不 要 将 私 钥 发 送 给 不 必要 的 一 方 ， 并 且 永 远 不 要 以 明文 发 送 或 存 
储 私 钥 。 


























Foo 
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下 面 介 绍 数据 是 如 何 由 发 送 方 进行 数字 签名 的 。AntiTamper.Signstring 方法 被 调用 ， 要 进 
行 签名 的 数据 被 传人 到 第 一 个 参数 (cleartext) 中 ， 一 个 字符 串 变 量 (rsaPublicKey) 是 
作为 第 二 个 参数 传 入 的 。rsaPublickey 变量 最 终 将 包含 公 钥 信 息 ， 该 信息 必须 用 于 随后 在 
AntiTamper.VerifySignedString 方法 中 验证 签名 。 


7 

















public static byte[] SignString(string clearText, out string rsaPublicKey) 


t 
byte[] signature = null; 
rsaPublicKey - null; 


byte[] encodedClearText - Encoding.Unicode.GetBytes(clearText); 


using (SHA512CryptoServiceProvider sha512 = 
new SHA512CryptoServiceProvider()) 


{ 
using (RSACryptoServiceProvider rsa = 
new RSACryptoServiceProvider(RSA KEY SIZE)) 
{ 
signature = rsa.SignData(encodedClearText, sha512); 
rsaPublicKey = rsa.ToXmlString(false); 
} 
} 


return signature; 


} 


首先 ，SignString 方法 创建 一 个 SHAS12CryptoServiceProvider 对 象 ， 它 将 用 于 创建 将 会 被 
数字 签名 的 散 列 。 此 处 要 注意 到 ， 我 们 为 需要 保护 的 数据 创建 一 个 SHA-512 散 列 值 。 然 
而 ， 我 们 并 没有 对 要 保护 的 数据 进行 签名 ， 而 是 对 SHA-512 散 列 值 签名 。 这 十 分 重要 ， 因 
为 非 对 称 密码 算法 本 身 是 很 慢 的 。 如 果 我 们 对 保护 的 数据 进行 签名 ， 并 且 这 些 数据 非常 大 
(例如 ， 大 小 达到 数 MB 或 数 GB)， 签 名 过 程 将 会 拖 慢 整个 系统 。 通 过 签署 小 得 多 的 散 列 
E (在 本 例 中 为 512 字 节 )， 我 们 不 需要 担心 性 能 瓶颈 。 


接 下 来 ,创建 一 个 将 会 用 来 对 数据 进行 签名 的 RSACryptoServiceProvider 对 象 。 
RSACryptoServiceProvider.SignData 实例 方法 接受 要 进行 签名 的 bytel] 形式 的 明文 数据 ， 
以 及 我 们 要 使 用 的 散 列 算法 (SHA-512)。 这 些 用 来 生成 散 列 值 ， 然 后 再 生成 数字 签名 。 此 
方法 仅 返回 数字 签名 。 

最 后 还 有 一 个 非常 重要 的 步骤 ， 即 捕获 RSACryptoServiceProvider 对 象 所 生成 的 公 钥 信息 。 
我 们 通过 调用 RSACryptoServiceProvider.ToxmlString 实例 方法 完成 这 一 步 。 此 方法 返回 
验证 签名 时 需要 的 公 钥 信息 。 

当 调 用 ToxMLString 时 ， 传 入 布尔 值 false 以 仅 返 回 公 钥 。 如 果 你 传 入 true， 
则 会 同时 返回 公 钥 和 私 钥 。 如 前 所 述 ， 对 密 钥 进行 保护 且 不 意外 地 分 发 是 非 

常 必要 的 。 






























































现在 发 送 方 所 要 做 的 就 是 将 数据 、 数 字 签 名 和 AntiTamper .SignString 方法 返回 的 公 钥 信 
息 发 送 给 预期 的 接收 方 ， 代 码 如 下 所 示 。 
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private static byte[] SendData(string originalString, out string rsaPublicKey) 








{ 
// 将 数据 发 送 到 目标 
byte[] signature = AntiTamper.SignString(originalString, out rsaPublicKey); 
// 将 数据 和 签名 发 送 到 目标 
return signature; 
} 


接收 方 然后 调用 AntiTamper.VerifySignedString 方法 ， 传 和 接收 到 的 数据 、 数 字 签 名 和 公 
钥 信 息 。 注 意 ，AntiTamper 类 在 发 送 方 和 接收 方 的 代码 中 都 需要 引用 到 。 


private static bool ReceiveData(string originalString, byte[] signature, 
string rsaPublicKey) 





// 从 发 送 方 接收 到 数据 
// 验证 数字 签名 


return (AntiTamper.VerifySignedString(originalString, signature, 
rsaPublicKey)); 


} 


VerifySignedString 方法 必须 使 用 发 送 方 在 之 前 的 Signstring 方法 中 使 用 过 的 相 
同 SHAS12CryptoServiceProvider 对 象 ， 否则 ， 签 名 将 无 法 验证 。 此 外 创建 了 一 个 
RSACryptoServiceProvider 对 象 ， 但 使 用 此 对 象 来 验证 签名 之 前 ， 调 用 RSACryptoService- 
Provider.FromXmLString 方 法 来 导入 正确 验证 签名 所 需 的 公 钥 信息 。 最 后 ， 
RSACryptoServiceProvider.VerifyData 方法 被 调用 以 验证 数据 及 其 签名 。 如 果 字 符 串 数据 
未 被 自 改 或 损坏 ， 此 方法 返回 布尔 值 true， 否 则 返回 false, 


public static bool VerifySignedString(string clearText, byte[] signature, 
string rsaPublicKey) 





( 


bool verified - false; 
byte[] encodedClearText - Encoding.Unicode.GetBytes(clearText); 


using (SHA512CryptoServiceProvider sha512 - 
new SHA512CryptoServiceProvider()) 
{ 


using (RSACryptoServiceProvider rsa = 
new RSACryptoServiceProvider(RSA KEY SIZE)) 
{ 


rsa.FromXmlString(rsaPublicKey); 
verified - rsa.VerifyData(encodedClearText, sha512, signature); 


j 


return verified; 
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11.4.4 ”参考 

MSDN x fh A AY "RsACryptoServiceProvider 2E" “SHA512CryptoServiceProvider 类 ”和 
“Encoding.Unicode.GetBytes 方法 ”主题 。 关 于 公 钥 的 更 多 信息 ， 参 考 维 基 百 科 的 “Public- 
key cryptography” , 


11.5 ”保证 安全 断言 的 安全 


11.5.1 ”问题 


你 希望 断言 在 调用 栈 的 某 个 特定 点 上 ， 一 个 给 定 的 权限 对 所 有 后 续 调 用 都 可 用 。 但 是 ， 这 
样 做 很 容易 打开 一 个 安全 漏洞 ， 允 许 其 他 恶意 代码 哄 骗 你 的 代码 或 者 在 你 的 组 件 中 创建 一 
个 后 门 。 你 希望 断言 一 个 给 定 的 安全 权限 ， 但 希望 以 一 种 安全 、 高 效 的 方式 进行 。 


11.5.2 ”解决 方案 


为 了 确保 该 方法 的 安全 ， 你 需要 调用 后 续 调用 所 需 的 权限 上 的 Demand。 这 会 确保 那些 不 
具有 这 些 权 限 的 代码 不 会 因为 Assert 而 蒙混 过 关 。pDemand 可 确保 你 在 使 用 对 栈 短路 的 
Assert 之 前 确实 已 经 获得 了 这 一 许可 。 这 通过 CallSecureFunctionSafelyAndEfficient- 
ly 函数 举例 进行 说 明 ， 它 在 调用 SecureFunction 之 前 ， 执 行 一 个 Demand 和 一 个 Assert, 
SecureFunction 相应 地 对 ReflectionPermission 执行 一 个 Demand, 


» &« 





























CallSecureFunctionSafelyAndEfficiently 的 代码 如 例 11-5 所 示 。 


例 11-5: CallSecureFunctionSafelyAndEfficiently 国 数 


public static void CallSecureFunctionSafelyAndEfficiently() 
{ 





// 建立 一 个 权限 以 便 能 够 通过 反射 访问 非 公 开 成 员 
ReflectionPermission perm = 
new Ref lectionPermission(ReflectionPermissionFlag.MemberAccess); 








// 在 使 用 Assert 前 请 求 编 制 的 权限 集 

// 以 确认 在 Assert 前 拥有 相应 的 权限 

// Demand 可 确保 我 们 在 使 用 对 栈 短路 的 Assert 之 前 

// 已 经 检查 了 这 一 权限 ,这 有 助 有 我 们 保持 安全 ,并 更 好 地 运行 


perm.Demand(); 


























// 在 调用 到 同样 执行 Demand 以 短路 每 个 
// 调用 生成 的 栈 之 前 断言 此 权限 
// 断言 帮助 我 们 优化 对 SecureFunction 的 使 用 


perm.Assert(); 





// 我 们 调用 安全 函数 100 次 ,但 仅 生成 从 该 函数 到 当前 调用 函数 的 堆栈 审核 ， 
// 而 不 是 审核 完整 的 堆栈 100 次 
for(int 1=0;i1<100;i++) 


{ 








SecureFunction(); 
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} 
} 


SecureFunction 的 代码 如 下 所 示 。 


public static void SecureFunction() 
{ 
// 建立 一 个 权限 以 便 能 够 通过 反射 访问 非 公开 成 员 
ReflectionPermission perm = 
new ReflectionPermission(ReflectionPermissionFlag.MemberAccess); 





// 请 求 执行 此 操作 的 权限 ,导致 一 个 堆栈 审核 


perm.Demand(); 





// 此 处 执行 动作 


11.5.8 Wit 

在 示例 函数 CallSecureFunctionSafelyAndEfficiently 中 ， 你 调用 的 国 数 (SecureFunc- 
tion) 执行 ReflectionPermission 上 的 一 个 Demand， 确 保 代 码 能 够 通过 反射 访问 非 公 开 的 
类 成 员 。 一 般 而 言 ， 对 于 SecureFunction 的 每 次 调用 ， 都 会 导致 一 次 栈 审核 。CallSecur- 
eFunctionSafelyAndEfficiently 中 的 Demand 只 保护 第 一 个 位 置 中 Assert 的 使 用 。 为 了 使 
之 效率 更 高 ， 你 可 以 使 用 Assert， 声 明 引 发 被 它 调 用 的 Demand 的 所 有 函数 不 会 再 引发 栈 
审核 。Assert 表示 停止 对 调用 栈 中 的 该 权限 进行 检查 。 为 了 完成 这 项 工作 ， 你 需要 调用 
Assert 的 权限 。 

使 用 Assert 会 引发 问题 ， 因 为 它 在 通过 CallSecureFunctionSafelyAndEfficiently 调 
用 SecureFunction 的 地 方 打 开 一 个 潜在 的 引诱 攻击 ， 它 调用 Assert BH 1E Demand 引发 
SecureFunction 的 栈 审 核 。 假 使 未 带 Ref LectionPermission 的 未 授权 代码 能 够 调用 Call- 
SecureFunctionSafelyAndEfficiently, JPA Assert 将 会 阻止 SecureFunction 的 Demand 调 
用 ， 而 此 Demand 调用 是 用 来 确定 调用 栈 中 是 否 存在 某 些 代码 不 具有 适当 的 权限 。 这 就 是 当 
一 个 Demand 发 生 时 CLR 中 调用 栈 检查 的 能 力 。 


为 了 防止 问题 的 发 生 ， 你 要 在 执行 Assert 之 前 对 CallSecureFunctionSafelyAndEfficient- 
ly 中 的 SecureFunction 所 需 的 ReflectionPermission 执行 一 个 Demand， 以 关闭 这 个 漏洞 。 
这 个 Demand 和 Assert 的 联合 使 用 会 导致 一 次 栈 审 核 ， 而 不 是 最 初 由 SecureFunction 中 的 
Demand 所 引发 的 100 次 。 


安全 性 优化 技术 ， 例 如 在 这 种 情况 下 使 用 Assert (即使 它 不 是 使 用 Assert 的 主要 原因 )， 
可 帮助 类 库 和 受信 任 的 控件 开发 人 员 执 行 Assert， 从 而 加 速 其 代码 与 CLR 的 交互 ; 但 如 
有 果 使 用 不 当 ， 这 些 技术 也 可 能 打开 安全 规划 中 的 漏洞 。 这 个 示例 说 明 在 涉及 安全 访问 时 你 
可 以 同时 兼顾 性 能 和 安全 性 。 

如 果 你 正在 使 用 Assert， 那 么 请 留心 不 要 在 类 构造 函数 中 进行 栈 审核 重 写 。 构 造 函 数 不 能 
保证 拥有 任何 特定 的 安全 上 下 文 ， 也 不 能 保证 在 特定 时 间 点 上 执行 。 因 此 ， 调 用 栈 无 法 很 
好 地 进行 定义 ， 而 这 里 使 用 的 Assert 可 能 产生 意 想不到 的 结果 。 


使 用 Assert 要 记 住 的 另 一 件 事 是 在 某 一 时 间 内 一 个 函数 中 只 能 有 一 个 激活 的 Assert。 如 
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果 对 相同 的 许可 Assert 两 次 ， 那 么 CLR 将 会 引发 一 个 SecurityException。 你 必须 首先 使 
用 RevertAssert 撤消 最 初 的 Assert， 然 后 再 声明 第 二 个 Assert, 

















11.5.4 ”参考 


MSDN 文 档 中 的 “CodeAccessSecurity.Assert Jy 法 " "CodeAccessSecurity.Demand 7j 
ik" "CodeAccessSecurity.RevertAssert 方法 ”和 “Overriding Security Checks” 主 题 。 


11.6 ”验证 是 否 已 授予 程序 集 特定 权限 


11.6.1 问题 


当 你 的 程序 集 使 用 SecurityAction.RequestOptional 标志 要 求 可 选 的 权限 (例如 ， 要 求 磁 
盘 访问 使 用 户 将 数据 导出 到 磁盘 作为 一 个 产品 特性 ) 时 ， 它 可 能 获得 那些 权限 ， 也 可 能 
法 获得 。 不 管 怎样 ， 你 的 程序 集 仍 能 加 载 并 执行 。 你 需要 一 种 方法 去 验证 程序 集 是 否 确实 
得 到 了 那些 权限 。 这 有 助 于 防止 许多 安全 性 异常 的 引发 。 例 如 ， 如 果 你 选择 性 地 要 求 注册 
表 上 的 读 / 写 权 限 但 没有 获得 它们 ， 那 么 可 以 禁用 用 于 读 取 和 存储 注册 表 中 应 用 程序 设置 
的 用 户 界面 控件 。 


11.6.2 ”解决 方案 
如 下 使 用 SecurttyManager.IsGranted 方法 检查 你 的 程序 集 是 否 获得 了 可 选 的 权限 。 


using System; 

using System. Text.RegularExpressions; 
using System.Web; 

using System.Net; 

using System.Security; 














Regex regex = new Regex(@"http://www\.oreilly\.com/.*"); 
WebPermission webConnectPerm = new WebPermission(NetworkAccess. Connect,regex); 


PermissionSet pSet = new PermissionSet(PermissionState.None) ; 
pSet.AddPermission(webConnectPerm); 
if (pSet.IsSubsetOf(Assembly.GetExecutingAssembly().PermissionSet)) 


// 连接 到 O?Reilly 网 站 
} 


该 代码 为 O'Reilly 的 网 站 建立 一 个 Regex， 然 后 使 用 它 创建 一 个 WebPermission 用 于 连接 该 
站 点 和 包含 该 字符 串 的 所 有 站 点 。 然 后 通过 创建 一 个 新 的 不 包含 访问 受 保护 资源 权限 ( 即 
PermissionState.None) 的 PermissionSet 对 象 ， 将 webConnectPerm 权限 添加 到 新 创建 的 
PermissionSet 对 象 ， 并 且 最 后 检查 这 一 新 的 PermissionSet 对 象 是 否 为 执行 中 的 程序 集 的 
权限 集 的 子 集 来 检查 WebPermission, 
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11.6.3 it 

IsSubsetOf 方法 是 一 个 轻 量 级 方法 ， 用 于 确定 权限 是 否 被 赋予 某 个 程序 集 ， 无 需 一 个 
Demand 调用 首先 带 来 的 完全 栈 审核 。 但 要 注意 ， 一 旦 你 运行 了 执行 Demand 的 代码 ， 那 么 
将 会 引发 完全 栈 审核 。 

你 需要 设计 具备 可 选 权 限 的 程序 集 的 一 个 原因 是 为 了 适应 不 同 客户 环 境 中 的 部 署 。 在 其 些 
情况 下 (例如 桌面 应 用 程序 )， 拥 有 一 个 能 够 执行 更 健壮 动作 (与 数据 库 会 话 ， 创 建 网 络 
通信 ， 等 等 ) 的 程序 集 是 可 接受 的 。 在 其 他 情况 下 ， 如 果 客 户 不 希望 为 这 些 额 外 服务 的 运 
行 赋予 足够 的 权限 ， 那 么 你 可 以 推迟 这 些 动 作 。 









































11.6.4 参考 


MSDN 文档 中 的 “WebPermission 类 ”“SecurityManager 类 ”和 “IsSubset0f 方法 ”主题 。 


11.7. 最 小 化 程序 集 的 攻击 面 


11.7.1 问题 


攻击 你 的 程序 集 的 某 个 人 首先 会 试图 尽量 多 地 找 出 关于 你 的 程序 集 的 信息 ， 然 后 在 构建 攻 
击 时 使 用 这 些 信息 。 你 为 攻击 者 留 出 的 区 域 越 多 ， 他 们 能 够 使 用 的 就 越 多 。 你 需要 将 自己 
的 程序 集 所 人 允许 做 的 事 最 小 化 。 这 样 ， 如 果 一 个 攻击 者 成 功 接管 它 ， 那 么 攻击 者 将 无 法 获 
得 对 系统 造成 任何 损失 的 必要 权限 。 


11.7.2 ”解决 方案 


使 用 SecurityAction.RequestRefuse 枚 举 成 员 在 程序 集 级 别 上 指定 你 不 希望 该 程序 集 拥有 
的 权限 。 这 将 强制 CLR 拒绝 把 这 些 权限 授予 你 的 代码 ， 并 且 确 保 即 使 系统 的 另 一 部 分 受 
到 威胁 ， 你 的 代码 也 不 会 用 于 执行 不 需要 权限 的 功能 。 

下 列 示例 允许 程序 集 执 行文 件 VO 作为 其 最 小 许可 集 的 一 部 分 ， 但 显 式 地 拒绝 允许 该 程序 
集 拥 有 权限 以 跳 过 验证 : 


[assembly: FileIOPermission(SecurityAction.RequestMinimum,Unrestricted=true) ] 
[assembly: SecurityPermission(SecurityAction.RequestRefuse, 
SkipVerification=false) ] 






































11.7.3 讨论 


一 旦 你 决定 了 你 的 程序 集 需 要 哪些 权限 作为 其 普通 安全 测试 的 一 部 分 ， 那 么 就 可 以 使 用 
RequestRefuse 锁定 代码 。 如 果 这 看 起 来 比较 极端 ， 那 么 可 考虑 你 的 代码 能 够 访问 一 个 包 
含 敏感 信息 的 数据 存储 的 情况 ， 例 如 社保 号 或 工资 信息 。 这 一 积极 步骤 有 助 于 你 向 客户 展 
示 自 己 对 待 安全 性 的 认真 态度 ， 并 且 当 入 侵 发 生 在 把 你 的 代码 作为 其 一 部 分 的 系统 上 时 有 
助 于 保护 你 的 利益 。 
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对 该 方法 需要 慎重 考虑 的 是 ， 使 用 RequestRefuse 会 将 你 的 程序 集 标 记 为 部 分 受信 任 的 。 
这 相应 地 阻止 了 它 调用 任何 未 使 用 AL LowPartiallyTrustedCallers 属性 标记 的 强 命名 程 
序 集 。 


11.7.4 参考 
MSDN 文档 中 的 “通过 部 分 受信 


Y 


主题 。 


11.8 获得 安全 和 /或 审计 信息 


11.8.1 问题 
你 需要 获得 一 个 文件 或 注册 表 项 的 安全 权限 和 /或 审计 信息 。 


11.8.2 ”解决 方案 


当 要 获取 一 个 文件 的 安全 和 /或 审计 信息 时 ， 可 使 用 File 类 的 静态 GetAccessControl 方 
法 ， 以 获得 一 个 System.Security.AccessControl.FileSecurity 对 象 。 使 用 FileSecurity 


对 象 访问 文件 的 安全 和 审计 信息 。 这 些 步骤 如 例 11-6 所 示 。 


例 11-6: 获得 安全 审计 信息 
public static void ViewFileRights() 








~ 


于 的 代码 使 用 库 ”“SecurityAction 枚 举 ” 和 “全 局 特性 ” 









































{ 
// 获得 一 个 文件 的 安全 信息 
string file = @"C:\Windows\win.ini"; 
FileSecurity fileSec = File.GetAccessControl(file); 
DisplayFileSecurityInfo(fileSec); 
} 


public static void DisplayFileSecurityInfo(FileSecurity fileSec) 
{ 
Console.WriteLine($"GetSecurityDescriptorSddlForm: 
{fileSec.GetSecurityDescriptorSddlForm(AccessControlSections.ALl)}"); 


foreach (FileSystemAccessRule ace in 
fileSec.GetAccessRules(true, true, typeof(NTAccount) )) 

{ 

Console.WriteLine("\tIdentityReference.Value: 
{ace.IdentityReference.Value}"); 

Console.WriteLine($"\tAccessControlType: {ace.AccessControlType}"); 
Console.WriteLine($"\tFileSystemRights: {ace.FileSystemRights}"); 
Console.WriteLine($"\tInheritanceFlags: {ace.InheritanceFlags}"); 
Console.WriteLine($"\tIsInherited: {ace.IsInherited}"); 
Console.WriteLine($"\tPropagationFlags: {ace.PropagationFlags}"); 


Console.WriteLine('"----------------- \r\n\r\n"); 





foreach (FileSystemAuditRule ace in 
fileSec.GetAuditRules(true, true, typeof(NTAccount) )) 

{ 

Console.WriteLine('"\tIdentityReference.VaLue: 
{ace.IdentityReference.Value}"); 

Console.WriteLine($"\tAuditFlags: {ace.AuditFlags}"); 
Console.WriteLine($"\tFileSystemRights: {ace.FileSystemRights}"); 
Console.WriteLine($"\tInheritanceFlags: {ace.InheritanceFlags}"); 
Console.WriteLine($"\tIsInherited: {ace.IsInherited}"); 
Console.WriteLine($"\tPropagationFlags: {ace.PropagationFlags}"); 
Console.Writeline("----------------- \r\n\r\n"); 


} 


Console.WriteLine($"GetGroup(typeof(NTAccount) ).Value: 
{fileSec.GetGroup( typeof (NTAccount)).Value}"); 

Console.WriteLine($"GetOwner (typeof (NTAccount) ).Value: 
{fileSec.GetOwner (typeof (NTAccount)).Value}"); 


ConsotLe.NriteLine("------------- \r\n\r\n\r\n"); 
} 


这 些 方法 产生 下 列 输出 。 


GetSecurityDescriptorSddlForm: 0:SYG:SYD:AI(A;ID;FA;;;SY)(A;ID;FA;;;BA) 
(A; ID; 0x1200a9; ; ; BU) (A; ID; 0x1200a9; ; ;AC) 
IdentityReference.Value: NT AUTHORITY\SYSTEM 
AccessControlType: Allow 





FileSystemRights: 
InheritanceFlags: 
IsInherited: True 
PropagationFlags: 


IdentityReference. 
AccessControlType: 


FileSystemRights: 
InheritanceFlags: 
IsInherited: True 
PropagationFlags: 


IdentityReference. 
AccessControlType: 


FileSystemRights: 
InheritanceFlags: 
IsInherited: True 
PropagationFlags: 


IdentityReference. 
APPLICATION PACKAGE AUTHORITYMALL APPLICATION PACKAGES 


FullControl 
None 


None 


Value: BUILTIN\Administrators 
Allow 

FullControl 

None 


None 


Value: BUILTIN\Users 

Allow 

ReadAndExecute, Synchronize 
None 


None 


Value: 





AccessControlType: Allow 

FileSystemRights: ReadAndExecute, Synchronize 
InheritanceFlags: None 

IsInherited: True 

PropagationFlags: None 


GetGroup(typeof(NTAccount)).Value: NT AUTHORITY\SYSTEM 
GetOwner(typeof(NTAccount)).Value: NT AUTHORITY\SYSTEM 
当 要 获取 一 个 注册 表 项 的 安全 和 /或 审计 信息 时 ， 可 使 用 已 crosoft.Win32.RegistryKey 类 
的 GetAccessControl 方法 ， 获 得 一 个 System.Security.AccessControl.RegistrySecurity 对 
象 。 使 用 RegistrySecurity 对 象 访问 该 注册 表 项 的 安全 和 审计 信息 。 这 些 步 又 如 例 11-7 


所 示 。 























例 11-7: 获得 一 个 注册 表 项 的 安全 或 审计 信息 
public static void ViewRegKeyRights() 


{ 














// 获得 一 个 注册 表 项 的 安全 信息 














using (RegistryKey regKey = 
Registry.CurrentUser .OpenSubKey(@"Software\Microsoft\VisualStudio\14.0")) 


{ 


RegistrySecurity regSecurity = regKey.GetAccessControl(); 
DisplayRegKeySecurityInfo(regSecurity); 


} 


public static void DisplayRegKeySecurityInfo(RegistrySecurity regSec) 


{ 


Console.WriteLine($"GetSecurityDescriptorSddlForm: 
{fileSec.GetSecurityDescriptorSddlForm(AccessControlSections.All)}"); 


foreach (RegistryAccessRule ace in 
regSec.GetAccessRules(true, true, typeof(NTAccount))) 


{ 


Console. 


Console 
Console. 
Console. 
Console. 
Console. 


Console. 


j 


WriteLine("\tIdentityReference.Value: 
(ace.IdentityReference.Value]"); 


.WriteLine($"\tAccessControlType: {ace.AccessControlType}"); 


WriteLine($"\tFileSystemRights: {ace.FileSystemRights}"); 
WriteLine($"\tInheritanceFlags: {ace.InheritanceFlags}"); 
WriteLine($"\tIsInherited: {ace.IsInherited}"); 

WriteLine($"\tPropagationFlags: {ace.PropagationFlags}"); 


Writeline(*--- seen \r\n\r\n"); 


foreach (RegistryAuditRule ace in 
regSec.GetAuditRules(true, true, typeof(NTAccount))) 


{ 


Console. 


Console. 
Console. 


WriteLine("\tIdentityReference.Value: 
{ace.IdentityReference.Value}"); 

WriteLine($"\tAuditFlags: {ace.AuditFlags}"); 

WriteLine($"\tFileSystemRights: {ace.FileSystemRights}"); 





Console.WriteLine($"\tInheritanceFlags: {ace.InheritanceFlags}"); 
Console.WriteLine($"\tIsInherited: {ace.IsInherited}"); 
Console.WriteLine($"\tPropagationFlags: {ace.PropagationFlags}"); 


Console.WriteLine('"----------------- \r\n\r\n"); 


} 
Console.WriteLine($"GetGroup(typeof(NTAccount) ).Value: 


(fileSec.GetGroup(typeof(NTAccount)) .Value]"); 
Console.WriteLine(S"GetOwner(typeof(NTAccount)).Value: 
{fileSec.GetOwner (typeof (NTAccount)).Value}"); 


ConsotLe.NriteLine("------------- \r\n\r\n\r\n"); 
} 


这 些 方法 产生 下 列 输出 。 





GetSecurityDescriptorSddlForm: 0:S-1-5-21-3613598369 - 3284219489 -1294304910-1001G: 


S-1-5-21- 3613598369 - 3284219489 - 1294304910-1001D: 
(A; OICIID;KA; ; ;S-1-5-21-3613598369- 3284219489 -1294304910-1001) 
(A;OICIID;KA;;;SY)(A;OICIID;KA; ; ;BA)(A;OICIID;KR; ;;RC) 
IdentityReference.Value: VM_Win81_VS14\Teilhet 
AccessControlType: Allow 
RegistryRights: FullControl 
InheritanceFlags: ContainerInherit, ObjectInherit 
IsInherited: True 
PropagationFlags: None 


IdentityReference.Value: NT AUTHORITY\SYSTEM 
AccessControlType: Allow 

RegistryRights: FullControl 

InheritanceFlags: ContainerInherit, ObjectInherit 
IsInherited: True 

PropagationFlags: None 


IdentityReference.Value: BUILTIN\Administrators 
AccessControlType: Allow 

RegistryRights: FullControl 

InheritanceFlags: ContainerInherit, ObjectInherit 
IsInherited: True 

PropagationFlags: None 


IdentityReference.Value: NT AUTHORITY\RESTRICTED 
AccessControlType: Allow 

RegistryRights: ReadKey 

InheritanceFlags: ContainerInherit, ObjectInherit 
IsInherited: True 

PropagationFlags: None 
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GetGroup(typeof(NTAccount)).Value: VM_WIN81_VS14\Teilhet 
GetOwner (typeof (NTAccount)).Value: VM_WIN81_VS14\Teilhet 


11.8.3 讨论 

用 于 获得 文件 或 和 注册 表 项 的 安全 信息 的 基本 方法 是 GetAccessControl 方法 。 当 在 
RegistryKey 对 象 上 调用 该 方法 时 ， 会 返回 一 个 Registrysecurity 对 象 。 但 是 ， 当 在 File 
类 上 调用 该 方法 时 ， 会 返回 一 个 FileSecurity 对 象 。RegistrySecurity 和 FileSecurity 对 
象 本 质 上 代表 一 个 自由 访问 控制 表 (discretionary access control list，DACL ) 。 非 托管 语言 
(例如 C++) 的 开发 人 员 习 惯 使 用 DACL。 

RegistrySecurity 和 FileSecurity 对 象 都 包含 一 个 安全 规则 列表 ， 应 用 于 它 代表 的 系统 对 
象 。RegistrySecurity 对 象 包含 一 个 RegistryAccessRule 对 象 的 列表 ， 而 FileSecurity 对 
象 包含 一 个 FileSystemAccessRule 对 象 的 列表 。 这 些 规 则 对 象 等 价 于 访问 控制 项 (access 
control entry，ACE) ， 构 成 了 一 个 DACL 中 安全 规则 的 列表 。 


除了 File 类 和 RegistryKey 对 象 之 外 的 系统 对 象 允 许 查询 安全 权限 。 表 11-1 列 出 了 所 有 
返回 一 个 安全 对 象 类 型 的 .NET Framework 类 以 及 安全 对 象 的 类 型 。 此 外 ， 还 列 出 了 安全 
对 象 中 包含 的 规则 对 象 类 型 。 

表 11-1: 所 有 *Security 和 *AccessRule 对 象 及 其 应 用 的 类 型 列表 






































ES GetAccessControl 方 法 返回 的 对 象 安全 对 象 中 包含 的 规则 对 象 类 型 
Directory DirectorySecurity FileSystemAccessRule 
DirectoryInfo DirectorySecurity FileSystemAccessRule 
EventWaitHandle EventWaitHandleSecurity EventWaitHandleAccessRule 

File FileSecurity FileSystemAccessRule 

FileInfo FileSecurity FileSystemAccessRule 
FileStream FileSecurity FileSystemAccessRule 

Mutex MutexSecurity MutexAccessRule 

RegistryKey RegistrySecurity RegistryAccessRule 

Semaphore SemaphoreSecurity SemaphoreAccessRule 


通过 *Security 对 象 对 一 个 系统 对 象 的 DACL 进行 抽象 和 通过 *AccessRule 对 象 对 DACL 
的 ACE 进行 抽象 ， 使 得 对 系统 对 象 安全 权限 的 访问 变 得 非常 容易 。 在 .NET Framework 之 
前 的 版 本 中 ， 这 些 DACL 及 其 ACE 仅 允 许 非 托管 代码 访问 。 对 于 .NET 2.0 Framework 及 
之 后 的 版 本 ， 你 能 够 查看 并 对 这 些 对 象 进行 编程 。 








11.8.4 84 


范例 11.9 (CHI 11.9 节 ) ; MSDN 文档 中 的 “System.I0.FiLe.GetAccessControl Fy 7” "System. 
Security.AccessControl.FileSecurity 2E" "Microsoft.Win32.RegistryKey.GetAccessRules 


Jjik" fH “System.Security.AccessControl.RegistrySecurity 类 ”主题 。 





11.9 授权 或 撤销 对 文件 或 注册 表 项 的 访问 


11.9.1 问题 
你 需要 以 编程 方式 修改 某 个 文件 或 注册 表 项 的 安全 权限 。 


11.9.2 解决 方案 
例 11-8 所 示 的 代码 授予 在 一 个 注册 表 项 上 执行 写 操作 的 权限 ， 然 后 撤销 。 
例 11-8: 授予 和 撤销 在 一 个 注册 表 项 上 执行 写 操作 的 权限 


public static void GrantRevokeRegKeyRights() 
{ 








NTAccount user = new NTAccount(@"WRKSTN\ST"); 


using (RegistryKey regKey = Registry.LocalMachine.OpenSubKey( 
@" SOFTWARE\MyCompany\MyApp" ) ) 
{ 
GrantRegKeyRights(regKey, user, RegistryRights.WriteKey, 
InheritanceFlags.None, PropagationFlags.None, 
AccessControlType.Allow); 


RevokeRegKeyRights(regKey, user, RegistryRights.WriteKey, 
InheritanceFlags.None, PropagationFlags.None, 
AccessControlType.Allow) 


} 


public static void GrantRegKeyRights(RegistryKey regKey, 
NTAccount user, 
RegistryRights rightsFlags, 
InheritanceFlags inherFlags, 
PropagationFlags propFlags, 
AccessControlType actFlags) 


{ 
Registry Security regSecurity = regKey.GetAccessControl(); 
RegistryAccessRule rule = new RegistryAccessRule(user, rightsFlags, inherFlags, 
propFlags, actFlags); 
regSecurity.AddAccessRule(rule); 
regKey.SetAccessControl(regSecurity); 
} 


public static void RevokeRegKeyRights(RegistryKey regKey, 
NTAccount user, 
RegistryRights rightsFlags, 
InheritanceFlags inherFlags, 
PropagationFlags propFlags, 
AccessControlType actFlags) 


RegistrySecurity regSecurity - regKey.GetAccessControl(); 
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j 


RegistryAccessRule rule - new RegistryAccessRule(user, rightsFlags, inherFlags, 


propFlags, actFlags); 
regSecurity.RemoveAccessRuleSpecific(rule); 


regKey.SetAccessControl(regSecurity); 


例 11-9 中 所 示 的 代码 授予 删除 一 个 文件 的 权限 ， 然 后 撤销 。 
例 11-9: 授予 和 撤销 删除 一 个 文件 的 权限 


public static void GrantRevokeFileRights() 


{ 


j 


NTAccount user = new NTAccount(@"WRKSTN\ST") ; 


string file = @"c:\FOO.TXT"; 
GrantFileRights(file, user, FileSystemRights.Delete, InheritanceFlags.None, 
PropagationFlags.None, AccessControlType.Allow); 


RevokeFileRights(file, user, FileSystemRights.Delete, InheritanceFlags.None, 
PropagationFlags.None, AccessControlType.Allow); 


public static void GrantFileRights(string file, 


j 


NTAccount user, 
FileSystemRights rightsFlags, 
InheritanceFlags inherFlags, 
PropagationFlags propFlags, 
AccessControlType actFlags) 


FileSecurity fileSecurity - File.GetAccessControl(file); 

FileSystemAccessRule rule - new FileSystem AccessRule(user, rightsFlags, 
inherFlags, propFlags, 
actFlags); 

fileSecurity.AddAccessRule(rule); 

File.SetAccessControl(file, fileSecurity); 


public static void RevokeFileRights(string file, 


NTAccount user, 
FileSystemRights rightsFlags, 
InheritanceFlags inherFlags, 
PropagationFlags propFlags, 
AccessControlType actFlags) 


FileSecurity fileSecurity = File.GetAccessControl(file); 


FileSystemAccessRule rule - new FileSystemAccessRule(user, rightsFlags, 
inherFlags, propFlags, 
actFlags); 

fileSecurity.RemoveAccessRuleSpecific(rule); 

File.SetAccessControl(file, fileSecurity); 





11.9.3 讨论 

当 授予 或 撤销 对 文件 或 广 册 表 项 的 访问 权限 时 ， 你 需要 两 个 对 象 。 第 一 个 是 合法 
的 NTAccount 对 象 。 该 对 象 本 质 上 封装 了 一 个 用 户 或 组 账户 ， 需 要 用 来 创建 一 个 新 的 
RegistryAccessRule 或 一 个 新 的 FileSystemAccessRule, NTAccount 确定 该 访问 规则 将 应 用 
于 哪个 用 户 或 组 。 要 注意 ， 必 须 将 传递 给 NTAccount 构造 函数 的 字符 串 修改 为 一 个 在 你 机 
器 中 存在 的 合法 用 户 名 或 组 名 。 如 果 传 递 一 个 已 禁用 的 现存 用 户 或 组 账户 ， 将 会 引发 一 个 
带 有 消息 “ 某 些 或 全 部 身份 3 用 无 法 被 转换 ”的 IdentityNotMappedException, 


所 需 的 第 二 项 是 一 个 合法 的 RegistryKey 对 象 (如果 你 要 修改 对 注册 表 项 的 安全 访问 )， 或 

者 是 一 个 包含 指向 现 有 文件 的 合法 路 径 和 文件 名 的 字符 串 。 这 些 对 象 将 具有 授权 给 它们 或 

者 从 它们 中 撤销 的 安全 性 权限 。 

一 旦 获得 了 这 两 项 ， 就 可 以 使 用 第 二 项 获得 一 个 安全 对 象 ， 它 包含 访问 — 规则 对 象 列 表 。 

例如 ， 下 列 代码 获得 注册 表 项 HKEY- LOCAL_MACHINE\ SOFTWARE\MyCompany\MyApp 的 安全 对 象 。 
RegistryKey regKey = Registry.LocalMachine.OpenSubKey( 


@" SOFTWARE\MyCompany\MyApp" ) ; 
RegistrySecurity regSecurity = regKey.GetAccessControl(); 


下 列 代码 获得 FOO.TXT 文件 的 安全 对 象 。 

string file = @"c:\FOO.TXT"; 

FileSecurity fileSecurity = File.Get AccessControl(file); 
既然 你 拥有 了 特定 的 安全 对 象 ， 就 可 以 创建 一 个 随后 需要 添加 到 该 安全 性 对 象 上 的 访问 — 
规则 对 象 。 为 此 ， 你 需要 创建 一 个 新 的 访问 规则 。 对 于 一 个 注册 表 项 ， 必 须 创 建 一 个 新 的 
RegistryAccessRule 对 象 ， 对 于 一 个 文件 ， 必 须 创 建 一 个 新 的 FileSystemAccessRule 对 象 。 
为 了 将 该 访问 规则 添加 到 正确 的 安全 性 对 象 中 ， 只 需 调用 安全 对 象 上 的 SetAccessControl 
方法 即 可 。 要 注意 ，RegistryAccessRule Xf & H AE WS Mn Bl] RegistrySecurity E, 而 
FileSystemAccessRule 对 象 只 能 够 添加 到 FileSecurity 对 象 上 。 
要 从 系统 对 象 中 删除 一 个 访问 -规则 对 象 ， 可 遵循 相同 的 步骤 ， 只 是 要 调用 
RemoveAccessRuleSpecific 方法 而 不 是 AddAccessRule 方法 。RemoveAccessRuLeSpecific 接 
受 一 个 访问 一 规则 对 象 ， 并 试图 从 安全 性 对 象 中 删除 完全 匹配 该 规则 对 象 的 规则 。 与 往常 
一 样 ， 你 必须 记 住 要 调用 SetAccessControl 方法 ， 以 将 所 有 修改 应 用 于 实际 的 系统 对 象 。 


对 于 其 他 人 允许 通过 编程 修改 安全 性 权限 的 类 型 列表 ， 请 参考 范例 11.8 (BN 11.8 17), 
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11.94 参考 


范例 11.8 ( 即 11.8 45) ; MSDN 3c#¥ AY “System. IO.File.GetAccessControl Y j;" "System. 


Security.AccessControl.FileSecurity 2” "Sysem.Security.AccessControl.FileSystemAccessRule 


»&« 


类 " "Microsoft.Win32.RegistryKey.GetAccessControl 方法 System.Security.AccessControl. 
RegistrySecurity 25" All “System.Security.AccessControl.RegistryAccessRule 类 ”主题 。 
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11.10 使 用 安全 字符 串 保 护 字 符 串 数据 





11.10.1 问题 

你 需要 在 字符 串 中 存储 敏感 信息 ， 
数据 。 

11.10.2 ”解决 方案 
使 用 SecureString 对 象 。 





但 是 ， 你 不 希望 和 人 在 内 存 中 帘 视 到 该 





Vira 


要 将 一 个 流 对 象 中 的 文本 复制 到 一 个 SecureString 对 象 中 ， 可 使 用 下 列 方法 。 


public static SecureString CreateSecureString(StreamReader secretStream) 


{ 


SecureString secretStr 
char buf; 


new SecureString(); 


while (secretStream.Peek() >= 0) 


{ 


buf = (char)secretStream.Read(); 
secretStr.AppendChar (buf); 


} 


// 将 secretStr 对 象 标记 为 只 





读 


secretStr.MakeReadOnly(); 


return (secretStr); 


} 


要 从 包含 敏感 数据 的 字符 串 中 复制 文本 ， 可 使 用 下 列 方法 。 


public static SecureString CreateSecureString(string secret) 


{ 


SecureString secretStr 


new SecureString(); 


char[] buf = new char[1]; 
foreach (char c in secret) 


{ 


secretStr.AppendChar(c); 


} 


// 将 secretStr 对 象 标 记 为 只 读 
secretStr.MakeReadOnly(); 


return (secretStr); 


} 








要 从 一 个 SecureString XH rp AH 


上 明文 文本 ， 可 使 用 下 列 方法 。 


public static void ReadSecureString(SecureString secretStr) 








H 





// 为 了 读 
IntPtr secretStrPtr 
string nonSecureStr 





字符 串 , 你 需要 使 用 一 些 特殊 方法 
Marshal.SecureStringToBSTR(secretStr); 
Marshal.PtrToStringBSTR(secretStrPtr); 











// 使 用 未 保护 的 字符 串 


Console.WriteLine($"nonSecureStr = {nonSecureStr}"); 
Marshal. ZeroFreeBSTR(secretStrPtr) ; 


if (!secretStr.IsReadOnly()) 
{ 


secretStr.Clear(); 
} 
} 


11.10.3 iit 


SecureString 对 象 特 别 设计 用 于 包含 你 希望 保密 的 字符 串 数 据 。 你 可 能 希望 存储 在 
SecureString 对 象 中 的 数据 有 社会 安全 号 、 信 用 卡号 、PIN 码 、 密 码 、 雇 员 ID ， 或 者 其 他 
类 型 的 敏感 信息 。 


添加 到 SecureString 对 象 上 的 字符 串 数 据 会 立即 自动 进行 加 密 ， 当 从 SecureString 对 象 中 
提取 字符 串 数据 时 会 自动 进行 解密 。 加 密 是 使 用 这 个 对 象 的 亮点 之 一 。 

SecureString 对 象 的 另 一 特性 是 当 调 用 了 MakeReadOnly 方法 后 ，SecureString 将 成 为 
不 可 变 的 。 任 何 修改 只 读 SecureString 对 象 内 字符 串 数 据 的 企图 都 会 导致 引发 一 个 
InvalidOperationException, —-H SecureString 对 象 被 置 为 只 读 ， 那 么 它 将 无 法 回 到 读 / 
写 状态 。 尽 管 如 此 ， 在 调用 一 个 现 有 的 SecureString 对 象 上 的 Copy 方法 时 需要 小 心 。 该 
方法 将 创建 被 调用 的 SecureString 对 象 的 一 个 新 实例 ， 并 带 有 其 数据 的 副本 。 但 是 ， 这 个 
新 Securestring 对 象 现 在 是 可 读 写 的 。 你 应 当 审 查 自己 的 代码 ， 以 确定 是 否 应 将 这 个 新 
SecureString 对 象 与 其 原始 SecureString 对 象 一 样 设置 为 只 读 。 

































































SecureString 对 象 只 能 用 于 Windows 2000 ( 带 Service Pack 3 或 更 高 版 本 ) 
或 之 后 的 操作 系统 。 





在 本 范例 中 ， 通 过 从 一 个 流 中 读 取 的 数据 或 一 个 简单 字符 串 创 建 一 个 SecureString 对 象 。 
这 个 数据 还 可 以 使 用 非 安全 代码 从 一 个 char* 获得 。SecureString 对 象 包含 一 个 构造 图 数 ， 
接受 一 个 char* 类 型 的 参数 以 及 一 个 包含 长 度 值 的 整 型 参数 ， 它 决定 了 从 char* 中 获取 的 
字符 数 。 

从 SecureString 对 象 中 获得 数据 初 看 上 去 并 非 显 而 易 见 。 没 有 可 以 返回 一 个 SecureString 
对 象 中 包含 的 数据 的 方法 。 为 了 实现 这 一 点 ， 必 须 使 用 Marshal 类 上 的 两 个 静态 方法 。 第 
一 个 是 SecureStringToBSTR， 它 接受 SecureString 对 象 并 返回 一 个 IntPtr。 这 个 IntPtr 随 
后 被 传递 给 同样 位 于 Marshal 类 上 的 PtrToStringBSTR 方法 。PtrToStringBSTR 方法 然后 返 
回 一 个 包含 解密 的 字符 串 数据 的 非 安全 String 对 象 。 


一 旦 使 用 Securestring 对 象 完 成 了 工作 ， 就 应 当 调 用 Marshal 类 上 的 静态 ZeroFreeBSTR 77 
法 ， 用 0 填充 并 释放 在 从 Securestring 中 提取 数据 时 分 配 的 任何 内 存 。 作 为 附加 的 安全 措 





























施 ， 你 应 当 调用 SecureString 对 象 的 Clear 方法 ， 从 内 存 中 清 零 加 密 的 字符 串 。 如 果 你 将 
SecureString 对 象 置 为 只 读 ， 那 么 将 无 法 调用 Clear 方法 清空 数据 。 在 这 种 情况 下 ， 要 么 
必须 调用 SecureString 对 象 上 的 Dispose 方法 (此 处 使 用 一 个 using 语句 块 会 更 好 ) ， 要 么 
必须 依赖 垃圾 收集 器 从 内 存 中 删除 SecureString 对 象 及 其 数据 。 


要 注意 ， 当 你 将 一 个 Securestring 对 象 的 数据 放 入 一 个 不 安全 的 String 中 时 ， 其 数据 会 
变 得 对 一 个 恶意 攻击 者 可 见 。 因 此 ， 当 你 只 是 将 其 转换 为 一 个 不 安全 的 string 时 ， 承 受 
使 用 SecureString 带 来 的 麻烦 看 起 来 便 之 无 意义 。 但 是 ， 通 过 使 用 Securestring， 你 能 
够 降低 恶意 攻击 者 查看 内 存 中 该 数据 的 概率 。 此 外 ， 某 些 API 仅 能 接受 一 个 SecureString 
作为 参数 ， 因 此 你 无 需 其 将 转换 为 一 个 非 安 全 的 String。 例 如 ，ProcessStartInfo 在 其 
Password 属性 中 接受 一 个 作为 Securestring 对 象 的 密码 。 
































SecureString 对 象 不 是 保护 数据 的 银 弹 ， 但 它 是 你 能 够 为 应 用 程序 添加 的 另 
一 个 保护 层 。 








11.10.4 ”参考 
MSDN 文档 中 的 “SecureString 类 ”主题 。 


11.11 保护 流 数 据 


11.11.1 问题 


你 希望 使 用 范例 9.9 ( 即 9.9 节 ) 中 的 TCP 服务 器 与 范例 9.10 (HI 9.10 节 ) 中 的 TCP 客户 
端 进行 通信 。 但 是 ， 你 需要 加 密 通信 并 验证 它 在 传输 过 程 中 未 遭 算 改 。 


11.11.2 ”解决 方案 
用 客户 端 和 服务 器 上 更 安全 的 SslStream 类 替代 NetworkStream 类 。 更 安全 的 TCP 客户 端 
TCPClient SSL 的 代码 如 例 11-10 Aras. 


例 11-10: TCPClient_SSL 类 
class TCPClient SSL 
{ 








private TcpClient _client = null; 

private IPAddress _address = IPAddress.Parse("127.0.0.1"); 
private int _port = 5; 

private IPEndPoint _endPoint = null; 


public TCPClient_SSL(string address, string port) 
{ 

_address = IPAddress.Parse(address) ; 

_port = Convert.ToInt32(port); 
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.endPoint = new IPEndPoint( address, port); 


} 


public void ConnectToServer(string msg) 


{ 
try 


{ 


using (client = new TcpClient()) 


( 


client.Connect( endPoint); 
using(SslStreamsslStream = newSslStream( client.GetStream(), false, 
new RemoteCertificateValidationCallback 


(CertificateValidationCallback))) 


sslStream.AuthenticateAsClient("MyTestCert2"); 

















// 获得 要 发 送 消 息 的 字 节 数据 
byte[] bytes = Encoding.ASCII.GetBytes(msg); 
// 发 送 消息 
Console.WriteLine($"Sending message to server: { msg}"); 
sslStream.Write(bytes, 0, bytes.Length); 























// 获得 响应 
// 用 于 保存 响应 字 节 数据 的 缓冲 区 
bytes = new byte[1024]; 





// 显示 响应 

int bytesRead = sslStream.Read(bytes, 0, bytes.Length); 

string serverResponse = Encoding.ASCII.GetString(bytes, 0, 
bytesRead); 

Console.WriteLine($"Server said: { serverResponse}"); 


j 


catch (SocketException e) 


{ 
Console.WriteLine 
(S"There was an error talking to the server: f{e.ToString()}"); 


} 


private bool CertificateValidationCallback(objectsender, 
X509Certificate certificate, X509Chain chain, 
SslPolicyErrors sslPolicyErrors) 


t 

if (sslPolicyErrors == SslPolicyErrors.None) 

{ 
return true; 

} 

else 

{ 
if (sslPolicyErrors == SslPolicyErrors.RemoteCertificateChainErrors) 
{ 


Console.WriteLine("The X509Chain.ChainStatus returned an array " + 





"of X509ChainStatus objects containing error information."); 

} 
else if (sslPolicyErrors == 

SslPolicyErrors.RemoteCertificateNameMismatch) 
t 

Console.WriteLine( 
"There was a mismatch of the name on a certificate."); 

} 
else if (sslPolicyErrors == 

SslPolicyErrors.RemoteCertificateNotAvailable) 


t 
Console.WriteLine("No certificate was available."); 
} 
else 
t 
Console.WriteLine("SSL Certificate Validation Error!"); 
} 


} 


Console.WriteLine(Environment.NewLine + 
"SSL Certificate Validation Error!"); 
Console.WriteLine(sslPolicyErrors.ToString()); 


return false; 


j 
用 于 更 安全 的 TCP 服务 器 TCPServer SSL 的 代码 如 例 11-11 所 示 。 


例 11-11: TCPServer SSL 类 


class TCPServer SSL 

{ 
private TcpListener _listener = null; 
private IPAddress _address = IPAddress.Parse("127.0.0.1"); 
private int _port = 55555; 


#region CTORs 
public TCPServer_SSL() 


{ 
} 
public TCPServer_SSL (string address, string port) 
{ 
_port = Convert.ToInt32(port); 
address = IPAddress.Parse(address); 
} 


#endregion // CTORS 


#region Properties 

public IPAddress Address 

{ 
get { return _address; } 
set { _address = value; } 


j 


public int Port 
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} 


get { return _port; } 
set { _port = value; } 


#endregion 


public void Listen() 


{ 


} 











try 
{ 
_using(_listener = new TcpListener(_address, _port)) 
{ 
// 启动 服务 器 
listener.Start(); 
// 进入 监听 循环 
while (true) 
{ 
Console.Write("Looking for someone to talk to... "); 
// 等 待 连接 
TcpClient newClient = _listener.AcceptTcpClient(); 
Console.WriteLine("Connected to new client"); 
// 创建 线程 以 处 理 客 户 端 请 求 
ThreadPool.QueueUserWorkItem(new WaitCallback(ProcessClient), 
newClient); 
} 
} 
} 
catch (SocketException e) 
{ 
Console.WriteLine($"SocketException: {e}"); 
} 
finally 
E 
// 关闭 服务 器 
_listener.Stop(); 
} 


Console.WriteLine("Hit any key (where is ANYKEY?) to continue..."); 
Console.Read(); 


private void ProcessClient(object client) 


{ 


using (TcpClient newClient = (TcpClient)client) 
{ 











P<] 





// 用 于 读 取 数 据 的 缓冲 
byte[] bytes = new byte[1024]; 
string clientData = null; 





using (Ssl Stream sslStream = new SslStream(newClient.GetStream())) 


t 


sslStream.AuthenticateAsServer(GetServerCert("MyTestCert2"), false, 
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SslProtocols.Default, true); 





// 循环 以 接收 客户 端 发 送 的 所 有 数据 
int bytesRead = 0; 
while ((bytesRead = sslStream.Read(bytes, 





// 将 字 节 数据 转换 成 AsCII 字 符 串 


0，bytes.Length)) != 0) 


clientData = Encoding.ASCII.GetString(bytes, 0, bytesRead); 
Console.WriteLine($"Client says: {clientData}"); 


// 感谢 他 们 的 输入 


bytes = Encoding.ASCII.GetBytes("Thanks call again!"); 








// 发 送 回响 应 








ssl Stream.Write(bytes, 0, bytes.Length); 


} 
} 
} 
} 
private static X509Certificate GetServerCert(string subjectName) 
{ 
X509Store store = new X509Store(StoreName.My, StoreLocation.LocalMachine) ; 
store.Open(OpenFlags.ReadOnly); 
X509CertificateCollection certificate - 
store.Certificates.Find(X509FindType.FindBySubjectName, 
subjectName, true); 
if (certificate.Count » 0) 
return (certificate[0]); 
else 
return (null); 
} 


j 


11.11.3 “讨论 


XT TCP 服务 器 和 客户 端的 内 部 工作 以 及 如 何 运行 这 些 应 用 程序 的 更 多 信息 ， 请 参见 范例 


9.9 (Hi 9.9 节 ) 和 范例 9.10〈 即 9.10 市 )。 在 本 范例 中 ， 我 们 
端 转 换 为 使 用 Sslstrean 对 象 进行 安全 通信 所 需 的 修改 。 


SslStream 对 象 使 用 SSL 协议 提供 了 一 种 发 送 数据 的 安全 力 








只 阐述 将 TCP 服务 器 和 客户 





I 密 信道 。 不 过 ， 加 密 只 是 


Sslstream 对 象 中 的 内 置 安全 特性 之 一 。Sslstrean 的 另 一 个 特性 是 它 检 测 对 数据 的 恶意 其 
至 意外 修改 。 尽 管 数据 被 加 密 了 ， 它 在 传输 过 程 中 还 是 有 可 能 被 修改 。 为 了 确定 这 种 情况 
是 否 发 生 过 ， 数 据 在 发 送 前 要 使 用 一 个 散 列 进行 签名 。 当 接收 到 它 时 ， 对 数据 重新 计算 散 





列 并 比较 两 个 散 列 值 。 如 果 两 个 散 列 值 相等 ， 那 么 到 达 的 信息 





不 等 ， 那 么 表明 数据 在 传输 过 程 中 已 被 修改 了 。 























是 完好 无 损 的 ， 如 果 散 列 值 


SslStream 对 象 还 具有 使 用 客户 端 和 /或 服务 器 证 书 的 能 力 ， 以 验证 客户 端 和 /或 服务 器 ， 
而 且 如 果 客 户 端 还 需要 向 服务 器 证 明 身 份 ， 那 么 它 允 许 客户 端 向 服务 器 传递 一 个 证 书 。 这 

















些 证 书 被 用 于 证 明 发 行者 的 身份 。 例 如 ， 如 果 一 个 客户 端 使 用 


SSL 与 服务 器 连接 ， 那 么 服 


务 器 必须 向 客户 端 提供 一 个 证 书 ， 证 明 此 服务 器 就 是 它 所 说 的 服务 器 。 证 书 必须 由 可 信 的 








权威 方 发 出 。 所 有 可 信 的 证 书 都 存储 在 客户 端的 根 证 书 存储 中 





o 
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为 了 确保 TCP 服务 器 和 客户 端 能 够 成 功 地 进行 通信 ， 你 需要 建立 一 个 X.509 证 书 ， 用 于 
验证 TCP 服务 器 。 为 此 ， 使 用 makecert.exe 程序 建立 一 个 测试 证 书 。 此 实用 程序 随 Visual 
Studio 一 起 安装 ， 并 且 必 须 从 Admin Visual Studio 命令 提示 符 下 运行 。 创 建 一 个 简单 证 书 
的 语法 ， 如 下 所 示 。 


makecert -r -pe -n "CN-CSharpCookBook.net" -a sha512 -Len 4096 
-cy authority -sv CSCBNet.pvk CSCBNet.cer 


命令 选项 的 定义 如 下 所 示 。 

e -r 

证 书 将 会 是 自我 签名 的 。 自 我 签署 证 书 通常 由 网 站 的 开发 者 创建 并 签名 ， 在 其 网 站 被 产 
品 化 之 前 便于 其 网 站 的 测试 。 自 我 签名 证 书 不 能 提供 证 明 站 点 合法 的 证 据 。 

-pe 

证 书 的 密 钥 是 可 导出 的 ， 以 便 将 其 包括 在 证 书 之 内 。 

e -n "CN=MyTestCert2" 


发 布 者 的 证 书 名 称 。 名 称 跟 在 "CN=" 文本 后 面 。 





















































e -a sha512 

用 于 创建 数字 签名 的 算法 。sha512 是 可 用 算法 中 最 强 的 。 
e -len 4096 

密 钥 长 度 的 位 数 。 


e -cy authority 

此 证 书 的 类 型 。 类 型 可 以 是 end (最 终 实体 ) 或 authority (证 书 颁发 机 构 )。 
e -sv CSCBNet.pvk 

将 要 为 使 用 者 生成 的 密 铀 文件 的 名 称 。 
makecert.exe 程序 最 后 的 参数 是 输出 文件 名 ， 此 例 中 为 CSCBNet.cer。 这 将 在 硬盘 上 当前 工 
作 目 录 的 此 文件 中 生成 证 书 。 此 外 ， 第 二 个 生成 的 文件 为 CSCBNet.pvk。 这 是 密 钥 文件 。 
密 钥 文 件 和 证 书 文件 需要 转换 为 个 人 信息 交换 (.pfx) 文件 。 这 可 以 通过 在 Admin Visual 
Studio 命令 提示 符 下 运行 Pvk2Pfx.exe 工具 来 实现 ， 如 下 所 示 。 

pvk2pfx.exe -pvk CSCBNet.pvk -spc CSCBNet.cer -pfx CSCBNet.pfx -po CSCB 

选项 的 定义 如 下 所 示 。 
e -pvk 

密 钥 文件 名 。 
e -spc 

证 书 文件 名 。 
e -pfx 

生成 的 个 人 信息 交换 文件 名 。 
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e -po 

生成 的 个 人 信息 交换 文件 的 新 密码 。 
下 一 个 步骤 涉及 打开 Windows 资源 管理 器 并 右键 单 击 CSCBNet.cer 文件 。 这 会 显示 一 个 弹 
HH, Hih Install Certificate 菜单 项 ， 将 会 启动 一 个 向 导 ， 人 允许 你 将 该 .cer 文件 导入 到 证 
书 存储 中 。 向 导 的 第 一 个 对 话 框 如 图 11-1 所 示 。 单 击 “ 下 一 步 ” 按 钮 。 








* 证 书 导入 向 导 


欢迎 使 用 证 书 导入 向 导 


该 向 导 可 帮助 你 柠 证 书 、 证 书信 任 列表 和 证 书 咱 镑 列表 从 磁盘 复制 到 证 书 存 依 。 


由 证 书 颂 发 机 构 领 发 的 证 书 是 对 你 身份 的 确认 ， 亡 包 合用 来 保护 数据 或 建立 安全 网 阁 连 接 的 信 
B. 证书 存储 是 保存 证 书 的 系统 区 域 。 


macum 
四 当前 用 户 (GO 


O 本 地 计算 机 () 


ME F-D SR, 


ma 




















图 11-1: 证 书 导 入 向 导 的 第 一 步 





向 导 的 下 一 步 允 许 你 选择 希望 安装 自己 证 书 的 证 书 存储 。 这 个 对 话 框 如 图 11-2 所 示 。 保 持 
默认 状态 并 单 击 “ 下 一 步 ” 按 钮 。 
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x 
€ i 证 书 导 入 向 导 


证 书 存储 
证 书 存 信 是 保存 证 书 的 系统 区 域 . 
Windows 可 以 自动 渤 探 证 书 存储 ,你 也 可 以 为 证 书 指定 一 个 位 置 。 


ORTISH. RDIAAEUESTHAQU) 


O 梅 所 有 的 证 书 痢 放 入 下 列 存 储 (D) 











T—ERON 取消 








图 11-2: 在 证 书 导入 向 导 中 指定 证 书 存储 区 


向 导 的 最 后 一 步 如 图 11-3 所 示 。 在 这 个 对 话 框 中 ， 单 击 “ 完 成 ”按钮 。 








x 
€ i 证 书 导入 向 导 


正在 完成 证 书 导入 向 导 


BTR EESATS. 


你 已 指定 下 列 设置 : 


eese 
内 容 证 书 

















图 11-3: 证 书 导入 向 导 的 最 后 一 步 
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单 击 “ 完 成 ”按钮 后 ， 将 会 看 到 如 图 11-4 所 示 的 消息 对 话 框 ,表明 导入 成 功 。 








证 书 导入 向 导 X 


© 导入 成 功 . 














图 11-4: 证 书 导 入 成 功 消息 


一 旦 成 功 导入 了 证 书 文件 ， 你 需要 使 用 证 书 导入 向 导 将 .pfx 文件 导入 。 右 键 单 击 
CSCBNet.pfx 文件 ， 将 显示 一 个 弹出 式 菜 单 。 单 击 Install PFX 菜单 项 ， 将 会 启动 向 导 。 向 
导 中 的 第 一 个 对 话 框 如 图 11-5 所 示 。 保 持 默 认 设置 并 单 击 “ 下 一 步 ”。 











> 证 书 导入 向 导 


欢迎 使 用 证 书 导 入 向 导 


该 向 导 可 帮助 你 棕 证 书 、 证 书信 任 列表 和 证 书 咱 销 列 表 从 碰 盘 复制 到 下 书 存 依 。 


由 证 书 令 发 机 构 领 发 的 证 书 是 对 你 身份 的 确 兴 


它 包 含 用 来 保护 数据 或 建立 安全 网 洛 连 接 的 信 
息 。 证 书 存储 是 保存 证 书 的 系统 区 域 ， 


© Si; SP (C) 


O 本 地 计算 机 (U 


ME F-D BUR, 





CN ]| wa 

















图 11-5: 在 证 书 导 入 向 导 中 指定 密 钥 的 存储 区 


此 向 导 的 下 一 步 如 图 11-6 所 示 ， 要 求 你 选择 一 个 .pfx 文件 导入 。 使 用 浏览 按钮 浏览 文件 ， 
然后 单 击 “ 下 一 步 ”。 
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€ i 证 书 导 入 向 导 


要 导入 的 文件 
指定 要 导入 的 文件 。 





注 章 : 用 下 列 格式 可 以 在 一 个 文件 中 存储 全 个 证 书 : 
个 人 信息 交接 - PKCS #12 (.PFX..P12) 
MEEDE- PKCS #7 证 书 (.P78) 


Microsoft 系列 证 书 存储 (.SST) 








下 一 步 (N) Ra 














图 11-6: 指定 将 要 导入 的 证 书 存 储 区 的 个 人 信息 交换 文件 


下 一 步 如 图 11-7 所 未， 要 求 提供 创建 此 .pfx 文件 时 使 用 的 密码 。 注 意 ， 此 密码 是 我 们 在 
Pvk2Pfx.exe 命令 行 工 具 中 使 用 的 那个 。 实 际 的 密码 通过 -po 选项 开关 传人 到 此 工具 。 对 于 
我 们 的 示例 来 说 ， 我 们 使 用 CSS 作为 密码 。 在 此 向 导 页 上 的 文本 框 中 键入 密码 并 单 击 “ 下 
一 步 ”。 
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€ £5,085 


wn 
为 了 保证 安全 , 已 用 客 码 保护 私 租 . 


TOR EB. 


EHP): 





[]£E 0) 


导入 运 项 (1): 





口 记 用 强 私 铜 保护 (E)， 如 果 写 用 这 个 远 项 , 每 次 应 用 程序 使 用 私 钥 时 ， 你 都 会 收 到 担 
示 。 








Tr3518:18795] 9:280 EBR(M), ize fti EM SEO EUER ED, 








pa emi mE A). 


下 一 步 (N) 取消 




















图 11-7: 输入 个 人 信息 交换 文件 的 密码 


接 下 来 的 一 步 如 图 11-8 所 示 ， 要 求 你 选择 要 在 其 中 存储 此 .pfx 信息 的 证 书 存储 区 。 保 持 
默认 设置 并 单 击 “ 下 一 步 ”。 








€ i 证 书 导入 向 导 


ATHE 
证 书 存储 是 保存 证 书 的 系统 区 域 。 


Windows JUS Ras ， 你 也 可 以 为 证 书 指定 一 个 位 置 . 


@ 根据 证 书 芝 型 ， 包 动 应 择 证 书 存储 (U) 


人 〇 将 所 有 的 证 书 都 放 入 下 列 存储 (P) 








Crm ]| ws 














图 11-8: 在 证 书 导入 向 导 中 指定 个 人 信息 交换 文件 的 证 书 存储 区 
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向 导 的 最 后 一 步 如 图 11-9 所 示 ， 只 是 显示 了 在 向 导 前 述 页 面 中 指定 的 信息 。 单 击 “ 完 
成 ”按钮 完成 导入 。 在 单 击 “ 完 成 ”按钮 后 ， 将 会 看 到 图 11-4 中 的 消息 对 话 框 ， 表 明 导 
入 成 功 。 








€ ”证 书 导入 向 导 
正在 完成 证 书 导 入 向 导 


BS yen SIS SES. 


你 已 指定 下 列 设置 : 





[mp] mx 




















11-9: 个 人 信息 交换 文件 导入 成 功 的 消息 

此 时 ， 你 可 以 运行 TCP 服务 器 和 客户 端 ， 它 们 应 当 能 够 成 功 地 通信 。 

要 在 TCP 服务 器 项 目 中 使 用 SsLSstream， 需 要 创建 一 个 新 SsLStream 对 象 以 封装 TcpClient 
WER. 


SslStream SslStream = new SslStream(newClient.GetStream()); 


在 你 可 以 使 用 这 个 新 的 流 对 象 之 前 ， 必 须 使 用 下 列 代码 验证 服务 器 。 


SslStream.AuthenticateAsServer (GetServerCert("MyTestCert2"), 
false, SslProtocols.Default, true); 


GetServerCert 方法 找 出 用 于 验证 服务 器 的 服务 器 证 书 。 要 注意 传递 给 该 方法 的 名 称 ，; 

与 makecert.exe 工具 使 用 的 发 布 者 的 证 书 名 选项 开关 相同 (参考 -n 选项 开关 )。 该 证 书 作 
为 一 个 X509Certificate 对 象 从 GetServerCert 方法 中 返回 。 传 递 给 AuthenticateAsServer 
方法 的 下 一 个 参数 是 false， 表 示 不 需要 客户 端 证 书 。SstProtocols.Default 参数 表示 根据 
客户 端 和 服务 器 可 用 的 方法 选择 验证 机 制 (SSL 2.0、SSL 3.0. TLS 1.0 或 PCT 1.0)。 最 后 
的 参数 表示 证 书 将 被 检查 ， 查 看 它 是 否 已 被 撤消 。 




















要 在 TCP 客户 端 项 目 中 使 用 Sststream， 可 以 创建 一 个 新 的 Sststreanm 对 象 。 这 与 在 TCP 
服务 器 项 目 中 创建 的 方式 有 些许 不 同 。 


SsLStream SsLStream = new SslStream(_client.GetStream(), false, 
new RemoteCertificateValidationCallback(CertificateValidationCallback)); 


这 个 构造 函数 接受 来 自 client 字段 的 一 个 流 对 象 、 一 个 false 〈 指 示 与 client 字段 相关 
联 的 流 对 象 在 调用 了 SslStream 对 象 的 Close 方法 后 将 被 关闭 ) 和 一 个 验证 服务 器 证 书 的 
ZEE, CertificateValidationCallback 方法 在 服务 器 证 书 需要 验证 时 被 调用 。 检 查 服务 器 
证 书 ， 任 何 发 现 的 错误 都 传递 给 这 个 委托 方法 ， 以 允许 你 按 自己 的 意愿 进行 处 理 。 


接 下 来 调用 AuthenticateAsClient 方法 来 验证 服务 器 。 
SslStream.AuthenticateAsClient("MyTestCert2"); 

如 你 所 见 ， 多 做 一 点 额外 的 工作 ， 就 能 够 用 SslStream 替代 你 正在 使 用 的 当前 流 类 型 ， 以 

获得 SSL 协议 的 益处 。 


11.11.4 ”参考 
MSDN 文档 中 的 “Sslstrean 类 ”主题 。 
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11.12 加密 web.config 信 息 


11.12.1 问题 
你 需要 以 编程 方式 加 密 web.config 文件 中 的 数据 。 


11.12.2 解决 方案 
要 加 密 web.config 文件 节 (section) 中 的 数据 ， 可 使 用 下 列 方法 。 


public static void EncryptWebConfigData(string appPath, 
string protectedSection, 
string dataProtectionProvider ) 


System.Configuration.Configuration webConfig = 
WebConfigurationManager .OpenWebConfiguration(appPath) ; 

ConfigurationSection webConfigSection = 
webConfig.GetSection(protectedSection) ; 


if (!webConfigSection.SectionInformation. IsProtected) 
{ 
webConfigSection.SectionInformation.ProtectSection( 
dataProtectionProvider); 
webConfig.Save(); 


} 


} 
要 解密 web.config 文件 节 中 的 数据 ， 可 使 用 下 列 方法 。 





public static void DecryptWebConfigData(string appPath, string protectedSection) 


{ 
System.Configuration.Configuration webConfig = 
WebConfigurationManager .OpenWebConfiguration(appPath) ; 
ConfigurationSection webConfigSection = 
webConfig.GetSection(protectedSection) ; 
if (webConfigSection.Section Information. IsProtected) 
{ 
webConfigSection.SectionInformation.UnprotectSection(); 
webConfig.Save(); 
} 
} 


你 需要 在 编译 该 代码 之 前 将 System.Web 和 System. Configuration DLL 添加 到 自己 的 项 
目 中 。 


11.12.3 iit 
要 加 密 数据 ， 可 以 使 用 下 列 参 数 调 用 EncryptWebConfigData 方法 。 


EncryptWebConfigData("/WebApplicationi", "appSettings", 
"DataProtectionConfigurationProvider"); 


第 一 个 参数 是 Web 应 用 程序 的 虚拟 路 径 ， 第 二 个 参数 是 想 要 加 密 的 节 ， 最 后 一 个 参数 是 希 
望 用 于 加 密 数据 的 数据 保护 提供 者 。 
EncryptWebConfigData 方法 使 用 传递 给 它 的 虚拟 路 径 打 开 web.config 文件 。 这 是 通过 使 用 
WebConfigurationManager 类 的 OpenWebConfiguration 静态 方法 来 完成 的 。 


System.Configuration.Configuration webConfig = 
WebConfigurationManager .OpenWebConfiguration(appPath) ; 











该 方法 返回 一 个 System.Configuration.Configuration 对 象 ， 你 使 用 它 来 获得 web.config 
文件 中 希望 加 密 的 节 。 这 可 以 通过 调用 GetSection 方法 来 完成 。 


ConfigurationSection webConfigSection = webConfig.GetSection(protectedSection) ; 


该 方法 返回 一 个 用 于 加 密 文件 节 的 ConfigurationSection 对 象 。 加 密 可 以 通过 调用 
ProtectSection 方法 来 完成 。 


webConfigSection. SectionInformation.ProtectSection(dataProtectionProvider ) ; 


dataProtectionProvider 参数 是 一 个 字符 串 ， 指 示 你 希望 使 用 哪个 数据 保护 提供 者 加 密 
文件 节 人 信息。 两 个 可 用 的 提供 者 是 DpapiProtectedConfigurationProvider 和 RsaProtec- 
tedConfigurationProvider, DpapiProtectedConfigurationProvider 类 利用 数据 保护 API 
(DPAPI) 加 密 和 解密 数据 。RsapProtectedConfigurationProvider 类 利用 .NET Framework 
中 的 RsaCryptoServiceProvider 类 加 密 和 解密 数据 。 
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法 。 这 可 保存 对 web.config 文件 的 修改 。 如 果 未 调用 该 方法 ， 那 么 加 密 的 数据 将 不 会 被 
保存 。 

















要 解密 web.config 文件 中 的 数据 ， 可 以 调用 带 有 下 列 参数 的 DecryptWebConfigdata 方法 。 
DecryptWebConfigData("/WebApplicationi", "appSettings"); 

第 一 个 参数 是 Web 应 用 程序 的 虚拟 路 径 ， 第 二 个 参数 是 你 希望 解密 的 文件 节 。 

DecryptWebConfigData 方法 的 运行 方式 与 EncryptWebConfigData 方法 非常 相似 ， 不 同 点 是 

前 者 会 调用 UnprotectSection 方法 解密 web.config 文件 中 的 加 密 数 据 。 


webConfigSection.SectionInformation.UnprotectSection(); 


如 果 你 使 用 这 项 技术 加 密 web.config 文件 中 的 数据 ， 那 么 当 Web 应 用 程序 访问 web.config 
文件 中 的 加 密 数 据 时 ， 数 据 将 被 自动 解密 。 
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MSDN 文档 中 的 “System.ConfigurationSection.Configuration 类 ”主题 。 


11.13 ”获得 一 个 更 安全 的 文件 句柄 


11.13.1 问题 
你 希望 在 操作 一 个 非 托管 文件 句柄 时 拥有 的 安全 性 比 简单 IntPtr 所 能 提供 的 安全 性 更 多 。 


11.13.2 ”解决 方案 
使 用 Microsoft.Win32.SafeHandles.SafeFileHandle 对 象 封装 现 有 的 非 托管 文 件 句柄 。 


public static void WriteToFileHandle(IntPtr hFile) 





// 将 文件 句柄 封装 在 安全 句柄 包装 对 象 中 
using (Microsoft.Win32.SafeHandles.SafeFileHandle safeHFile = 
new Microsoft.Win32.SafeHandles.SafeFileHandle(hFile, true)) 
{ 
// 使 用 传 入 的 安全 句柄 打开 一 个 FiLeStream 对 像 
using (FileStream fileStream = new FileStream(safeHFile, 
FileAccess.ReadwWrite) ) 
{ 
// 在 开始 写 入 前 刷新 以 清理 任何 进行 中 的 非 托管 操作 
fileStream.Flush(); 
































// 此 时 开始 操作 文件 


string line = "Using a safe file handle object"; 








// 写 入 文件 中 
byte[] bytes = Encoding.ASCII.GetBytes(line); 
fileStream.Write(bytes,0,bytes.Length); 

} 


} 
// 注意 此 时 hFile 句 柄 已 无 效 





SafeFileHandle 的 构造 函数 接受 两 个 参数 。 第 一 个 是 IntPtr， 它 包含 指向 非 托管 资源 的 名 
柄 。 第 二 个 参数 是 一 个 布尔 值 ， 其 中 true 指示 句柄 总 是 在 析 构 期 间 释 放 ，false 指示 关闭 
强制 句柄 在 析 构 期 间 释 放 的 安全 措施 。 除 非 你 有 充足 的 理由 关闭 这 些 安全 措施 ， 否 则 建议 
尔 总 是 将 该 布尔 值 设置 为 true, 


11.13.3 ”讨论 


SafeFileHandle 对 象 包含 指向 非 托 管 文 件 资 源 的 单个 句柄 。 与 使 用 IntPtr 存储 一 个 句柄 相 
比 ， 该 类 有 两 个 主要 好 处 : 关键 终结 和 防止 句柄 重用 攻击 。 因 为 SafeFileHandle 的 基 类 之 
一 是 CriticalFinalizer0bject， 所 以 SafeFileHandle 被 垃圾 收集 器 视 为 一 个 关键 终结 器 。 
垃圾 收集 器 将 终结 器 分 为 两 类 : 关键 的 和 非 关 键 的 。 非 关 键 终结 器 首先 运行 ， 然 后 运行 关 
键 终结 器 。 如 果 一 个 FileStream 的 终结 器 刷新 了 任何 数据 ， 那 么 可 以 认为 SafeFileHandle 
对 象 仍 是 合法 的 ， 因 为 SafeFileHandle 终结 器 确保 在 FileStream 之 后 运行 。 


























FileStream 对 象 上 的 Close 方法 也 将 关闭 其 底层 的 SafeFileHandle HR, 














SafeFileHandle 被 昭和 人 关键 终结 器 ， 因 此 它 意 味 着 非 托 管 的 底层 句柄 总 会 被 释放 〈 即 总 是 
会 调用 SafeFileHandle.ReleaseHandle 方法 ) ， 即 使 在 AppDomain 被 损坏 、 关 闭 或 线程 被 中 
止 的 情况 下 也 会 如 此 。 这 将 防止 资源 句柄 泄露 。 

SafeFileHandle 对 象 也 有 助 于 防止 句柄 重用 攻击 。 操 作 系统 试图 积极 地 重复 使 用 句柄 ， 因 
此 关闭 一 个 句柄 随后 很 快 打开 另 一 个 新 句柄 有 可 能 得 到 相同 的 值 。 攻 击 者 利用 这 一 点 的 一 
种 方法 是 ， 强 制 一 个 线程 上 的 一 个 可 访问 句柄 关闭 ， 而 它 仍 可 能 被 用 在 另 一 个 线程 上 ， 这 
是 希望 句柄 很 快 能 被 重新 利用 并 用 作 一 个 指向 新 资产 的 句柄 ， 很 可 能 是 一 个 攻击 者 没有 权 
限 去 访问 的 句柄 。 如 果 应 用 程序 仍然 拥有 原始 句柄 并 主动 地 作用 它 ， 那 么 数据 损坏 就 可 能 
会 成 为 一 个 问题 。 

由 于 该 类 继承 自 SafeHandlezeroOrMinusOneIsInvalid 类 ，0 或 -1 的 句柄 值 被 认为 是 无 效 的 
句柄 。 

















11.13.4 ”参考 


MSDN 文档 中 的 “Microsoft.Win32.SafeHandles.SafeFileHandle 类 ”主题 。 


11.14 ”保存 密码 


11.14.1 问题 

你 需要 为 你 的 应 用 程序 的 用 户 以 安全 和 可 靠 的 方式 保存 密码 。 然 而 ， 你 不 希望 任何 拥有 提 
升 权 限 的 人 ， 例 如 系统 管理 员 ， 能 够 有 办 法 来 解密 存储 的 密码 。 此 外 ， 如 果 此 信息 被 攻击 
者 盗 取 ， 你 希望 他 解 开 原始 密码 的 难度 尽 可 能 大 一 些 。 





























11.14.02 解决 方案 

与 其 使 用 双向 加 密 算法 来 加 密 密 码 ， 这 类 算法 使 用 正确 的 密 钥 就 能 够 解密 密码 ， 我 们 将 使 
用 带 有 salt 值 (ERE) 的 单 向 散 列 算法 以 一 种 更 安全 的 方式 来 存储 密码 。 我 们 将 比较 散 列 
值 ， 而 不 是 比较 明文 密码 ， 从 而 隐藏 真正 的 密码 不 被 帘 视 。 











本 范例 使 用 范例 11.10 ( 即 11.10 节 ) 中 的 方法 ， 最 明显 的 是 CreateSecureString 
和 ReadSecurestring 方法 。 


我 们 以 创建 一 个 接受 明文 密码 的 方法 开始 ， 返 回 唯一 的 salt 值 (作为 out 参数 ) 和 经 过 散 
列 算 法 处 理 并 随机 生成 的 密码 〈 作 为 返回 值 )。 
const int HASH_ITERATIONS = 43; 


const string HASH_ALGORITHM = "SHA-512"; 
const int SALT_LENGTH = 64; 


public static SecureString GeneratePasswordHashAndSalt(SecureString passwd, 
out SecureString salt) 



































{ 
// 首先 生成 我 们 将 用 来 散 列 的 唯一 salt 
salt = GenerateSalt(); 
// 创建 加 盐 的 散 列 
string hashedPwd = GenerateHash(passwd, salt); 
return CreateSecureString(hashedPwd) ; 
} 


接 下 来 我 们 将 编写 生成 一 个 在 加 密 方面 的 强 随机 数字 的 方法 ， 该 随机 数字 将 用 作 salt 值 。 


private static SecureString GenerateSalt() 





{ 
RNGCryptoServiceProvider rng = new RNGCryptoServiceProvider(); 
byte[] salt = new byte[SALT_LENGTH]; 
rng.GetBytes(salt); 
return CreateSecureString(Convert.ToBase64String(salt)); 
} 














当然 ， 我 们 需要 一 个 接受 未 经 散 列 处 理 的 密码 和 上 述 GenerateSalt 方法 生成 的 salt 值 的 方 
法 ， 然 后 返回 最 终 的 密码 /salt 值 组 合 的 散 列 。 


private static string GenerateHash(SecureString clearTextData, SecureString salt) 


{ 











if (salt?.Length > 0) 


// 在 散 列 前 组 合 密码 和 satt 值 
byte[] clearTextDataArray = 
Encoding.UTF8.GetBytes(ReadSecureString(clearTextData)); 





byte[] clearTextSaltArray = 
Convert. FromBase64String(ReadSecureString(salt)); 


byte[] clearTextDataSaltArray = new byte[clearTextDataArray.Length + 
clearTextSaltArray.Length]; 
Array.Copy(clearTextDataArray, 0, clearTextDataSaltArray, 
0, clearTextDataArray.Length); 
Array.Copy(clearTextSaltArray, 0, clearTextDataSaltArray, 
ClearTextDataArray.Length, clearTextSaltArray.Length); 


// 使 用 一 个 安全 的 散 列 算法 
HashAlgorithm alg = HashAlgorithm.Create(HASH ALGORITHM); 


byte[] hashedPwd = null; 
for (int index = 0; index < HASH ITERATIONS; index++) 


if (hashedPwd == null) 
{ 

// 明文 密码 的 初始 散 列 

hashedPwd = alg.ComputeHash(clearTextDataSaltArray) ; 
} 


else 


// APSA PT A BC 
hashedPwd = alg.ComputeHash(hashedPwd) ; 


"i 








} 


return Convert.ToBase64String(hashedPwd) ; 
} 
else 
{ 
throw new ArgumentException( 
$"Salt parameter {nameof(salt)} cannot be empty or null. 
"This is a security violation."); 


+ 


} 
此 GenerateHash 方法 只 是 将 密码 和 salt 值 组 合成 单一 的 byte[]， 然 后 计算 此 组 合 值 的 散 
列 。 为 了 额外 的 安全 性 ， 散 列 值 重复 多 次 计算 散 列 。 散 列 迭 代 次 数 由 HASH_ITERATIONS $y 
量 控制 。 
一 旦 创建 了 最 终 的 散 列 加 盐 的 密码 值 ， 我 们 就 需要 在 数据 存储 中 为 此 用 户 保存 此 值 以 及 唯 
一 的 salt 值 。 下 列 伪 代码 为 你 展示 了 大 体 思 路 。 你 可 以 修改 此 代码 以 用 于 任何 数据 存储 。 


public static void SaveHashedPassword(string userName, SecureString pwdHash, 
SecureString salt) 























{ 
string base64PwdHash = ReadSecureString(pwdHash) ; 


string base64Salt = ReadSecureString(salt); 

// 保存 到 DB 

// INSERT users ('user', 'pwd', 'salt', ...) 

// (userName, base64PwdHash, base64Salt, ...)} 
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pwdHash 和 salt 参数 应 分 别 从 GeneratePasswordHashAndSalt 方法 的 返回 值 和 out 参数 
得 来 。 
现在 ， 我 们 可 以 创建 散 列 加 盐 的 密码 了 ， 我 们 需要 一 种 方法 来 比较 用 户 在 他 的 应 用 程序 登 
录 窗 体 的 密码 文本 框 中 输入 的 密码 和 存储 在 数据 存储 中 的 散 列 值 。 下 面 的 方法 将 用 户 输入 
的 密码 散 列 加 盐 ， 然 后 将 此 值 与 存储 在 数据 存储 中 同一 用 户 的 值 〈《 即 用 户 创建 的 原始 散 列 
加 盐 的 密码 ) 进行 比较 。 

public static bool ComparePasswords(SecureString storedHashedPwd, 


SecureString storedSalt, 
SecureString clearTextPwd) 

















try 


// 首先 使 用 同样 的 技术 来 散 列 明文 密码 
byte[] userEnteredHashedPwd = 
Convert. FromBase64String(GenerateHash(clearTextPwd, 
storedSalt)); 





// 获得 保存 的 散 列 加 盐 的 密码 
byte[ JoriginalHashedPwd = 
Convert. FromBase64String(ReadSecureString(storedHashedPwd) ) ; 





// 现在 比较 两 个 散 列 值 

// 如 果 为 true, 说 明 用 户 输入 的 密码 是 正确 的 

if (userEnteredHashedPwd.SequenceEqual(originalHashedPwd)) 
return true; 


catch(ArgumentException ae) 





// 此 处 你 应 该 记录 这 一 错误 并 返回 false 
Console.WriteLine(ae.Message); 
return false; 











} 


return false; 


} 


调用 此 方法 时 ， 必 须 从 最 初 存储 到 的 数据 存储 中 获取 storedHashedPwd 和 salt 参数 。 起 
初 ， 我 们 使 用 SaveHashedPassword 方法 中 的 伪 代 码 保存 了 这 些 值 。 下 面 是 读 取 这 些 值 的 另 
一 个 伪 代 码 方法 。 
public static void RetrieveHashedPasswordAndSalt(string userName, 
out SecureString 


storedHashedPwd, 
out SecureString storedSalt) 


























{ 
// 从 DB 中 读 取 
// SELECT pwd, salt FROM users WHERE user = ? 
// SetString(userName) ; 
storedHashedPwd = CreateSecureString(getFromResultSet("pwd")); 
storedSalt = CreateSecureString(getFromResultSet ("salt")); 
} 





和 上 面 一 样 ， 你 应 该 修改 这 些 伪 代码 来 处 理 特定 的 数据 存储 。 








11.14.3 讨论 
在 进入 如 何 使 用 这 些 代 码 的 细节 之 前 ， 让 我 们 讨论 一 下 在 此 代码 中 使 用 的 常量 值 。 


const int HASH_ITERATIONS = 43; 
const string HASH_ALGORITHM = "SHA-512"; 
const int SALT_LENGTH = 64; 


744, HASH ITERATIONS 值 简单 地 定义 了 明文 密码 /salt 组 合 将 进行 多 少 次 散 列 运算 。 在 此 
例 中 ， 密 码 /salt 值 进 行 散 列 处 理 ， 生 成 的 散 列 再 次 进行 散 列 ， 如 此 反复 ， 总 共 43 次 。 如 
As UR ie STE BO PA E A. WU As RAS S100, 200. 500 甚至 
1000。 但 是 ， 要 记 住 这 需要 处 理 能 力 来 创建 这 些 散 列 值 ， 攻 击 者 〈 可 能 使 用 僵尸 网 络 ) 可 
以 强行 导致 许多 散 列 生成 ， 从 而 导致 你 的 应 用 程序 拒绝 服务 。 


当 提示 用 户 注册 或 登录 时 显示 一 个 验证 码 ， 并 在 几 次 登录 失败 后 锁定 用 户 。 
这 个 办 法 可 以 防止 或 威慑 专注 于 使 你 的 服务 器 忙于 生成 散 列 值 的 拒绝 服务 
攻击 。 












































HASH ALGORITHM 值 定义 了 要 使 用 的 散 列 算法 。 使 用 SHA-256 或 SHA-512 是 安全 的 ， 不 过 
使 用 SHA-512 更 加 安全 。 请 不 要 使 用 容易 破解 的 散 列 算法 ， 例 如 MD5 或 SHA-1， 因 为 它 
们 将 显著 减少 攻击 者 破解 你 的 散 列 所 用 的 时 间 。 事 实 上 ， 不 要 使 用 任何 强度 低 于 SHA-256 
的 算法 。 

最 后 ，SALT_LENGTH 值 是 将 要 组 成 salt 值 的 字 节 数 。 这 些 字 节 由 一 个 密码 强 随机 数 生 成 器 生 
成 。 此 处 选择 的 salt 长 度 为 64 字 节 ， 但 也 可 以 更 长 或 更 短 。 我 们 选择 64， 因 为 这 是 散 列 
过 的 密码 和 salt 值 相 同 的 长 度 ， 迫 使 攻击 者 在 对 散 列 使 用 彩虹 表 或 反 向 查找 表 前 确定 哪 一 
个 是 salt 值 ， 哪 一 个 是 散 列 值 。 如 果 你 决定 使 用 SHA-256， 那 么 可 以 将 SALT. LENGTH 减 小 
到 32 字 节 以 与 散 列 值 的 大 小 相等 。 


继续 在 你 的 应 用 中 实现 此 代码 ， 有 两 个 地 方 应 当 使 用 此 代码 : 站 点 的 用 户 注册 和 登录 表单 

中 。 首 先 ， 我 们 来 逐步 讨论 注册 过 程 。 

(1) 用 户 选择 注册 此 网 站 的 用 户 名 和 密码 。 

(2) 此 网 站 要 求 用 户 输入 用 户 名 和 密码 ， 然 后 传递 到 GeneratePasswordHashAndSalt 方法 ， 
为 此 用 户 生 成 唯一 的 salt 值 和 散 列 加 盐 的 密码 。 

(3) 将 用 户 输入 的 用 户 名 与 数据 存储 进行 验证 ， 以 确定 是 否 存在 与 现 有 用 户 同 名 的 用 户 。 
































(4) 如 果 此 前 没有 同名 用 户 存在 ， 在 数据 存储 中 存储 用 户 名 、 散 列 加 盐 的 密码 和 唯一 的 
salt 值 。 


对 于 本 范例 ， 我 们 假设 在 注册 和 登录 窗 体 上 使 用 System.Windows.Controls. 
PasswordBox 控件 。 此 控件 可 以 在 PresentationFramework.dll 中 找到 。 此 控件 
具有 一 个 内 置 的 属性 SecurePassword， 使 我 们 能 够 获取 存储 在 SecureString 
对 象 中 而 不 是 一 个 普通 字符 串 对 象 中 的 密码 。 














代码 将 如 下 所 示 。 


public bool Register() 


{ 


} 


try 
{ 


SecureString salt; 
SecureString pwdHash = 
GeneratePasswordHashAndSalt(myRegPasswordTextBox.SecurePassword, 
out salt); 


// 测试 以 确保 此 用 户 名 可 用 于 注册 
if (UserDoesNotExist(myRegUserNameTextBox. Text) ) 








{ 
SaveHashedPassword(userName, pwdHash, salt); 
return true; 

} 

else 


return false; 


} 


catch(Exception e) 


} 


// 发 生 了 错误 ,登录 失败 


return false; 


我 们 调用 的 第 一 个 方法 是 GeneratePasswordHashAndSatt， 一 是 为 了 为 此 用 户 生 成 新 的 唯一 
salt 值 ， 二 是 为 了 对 用 户 注册 所 用 的 密码 进行 加 盐 和 散 列 。 


在 此 方法 中 ， 我 们 做 的 最 后 一 件 事 是 测试 ， 以 确保 在 数据 存储 中 此 用 户 名 并 不 存在 。 如 果 





重要 的 是 ， 为 每 个 用 户 生 成 唯一 的 salt 值 。 为 每 个 用 户 使 用 相同 的 salt 是 不 
安全 的 ， 因 为 它 使 攻击 者 更 加 容易 破解 所 有 散 列 的 密码 。 攻 击 者 要 做 的 就 是 
确定 一 个 salt 值 并 将 其 应 用 于 其 生成 的 每 个 散 列 值 。 


























它 不 存在 ， 我 们 继续 使 用 SaveHashedPassword 方法 在 数据 存储 中 存储 此 用 户 名 、 散 列 加 盐 

的 密码 和 唯一 salt。 否 则 注册 过 程 将 中 断 ， 用 户 必须 输入 一 个 不 同 的 用 户 名 。 

以 下 是 用 户 返 回 到 该 网 站 ， 并 试图 用 凭据 登录 的 过 程 。 

(1) 用 户 输入 自己 的 用 户 名 和 密码 。 

(2) 从 数据 存储 中 获得 此 用 户 唯一 的 salt 值 和 最 初 散 列 加 盐 的 密码 。 

(3) 用 户 输入 网 站 的 密码 (在 步骤 1 中 得 到 ) 和 此 用 户 的 唯一 salt 值 (在 步骤 2 中 得 到 ) 以 
及 散 列 加 盐 的 密码 (同样 在 步 又 2 中 得 到 ) 传人 ComparePasswords 方法 。 

(4) ComparePasswords 方法 简单 地 使 用 为 此 特定 用 户 存储 的 唯一 salt 值 加 盐 并 散 列 用 户 密 
码 ， 然 后 将 返回 的 散 列 与 此 用 户 存储 的 初始 散 列 相 比 较 。 
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(5) 如 果 散 列 值 完 全 相同 ， 用 户 就 可 以 继续 进行 身份 验证 :否则 ， 禁 止 该 用 户 进行 身份 
SE. 
代码 如 下 所 示 。 


public bool Login() 
{ 





try 
{ 


string userName = myLoginUserNameTextBox. Text; 


SecureString storedHashedPwd; 

SecureString storedSalt; 

RetrieveHashedPasswordAndSalt(userName, out storedHashedPwd, 
out storedSalt); 


if (ComparePasswords(storedHashedPwd, storedSalt, 
myLoginPwdTextBox.SecurePassword)) 


// 密码 散 列 符合 
return true; 


} 


else 


// 密码 散 列 不 符 ,登录 失败 
return false; 
} 
} 


catch(Exception e) 


// 发 生 了 错误 ,登录 失败 


return false; 


} 


首先 ， 这 段 代 码 使 用 由 用 户 输入 的 用 户 名 ， 通 过 RetrieveHashedPasswordAndSalt 方法 从 数 
据 存储 中 获得 散 列 加 盐 的 密码 以 及 用 户 的 唯一 salt 值 。 将 这 两 个 值 与 用 户 在 登录 窗 体 中 输 
入 的 密码 一 起 传 到 ComparePasswords 方法 。 此 方法 使 用 RetrieveHashedPasswordAndSalt 7j 
法 返回 的 相同 salt 值 散 列 并 加 盐 用 户 在 登录 窗 体 中 输入 的 密码 。 如 果 用 户 在 登录 窗 体 中 输 
入 的 散 列 加 盐 密码 与 存储 在 数据 存储 中 的 散 列 加 盐 密码 相同 ， 那 么 密码 匹配 并 且 爷 许 身 份 
验证 过 程 继续 进行 。 否 则 ， 身 份 验证 失败 。 






























































11.14.4 ”参考 


MSDN 文档 中 的 “System.Windows.Controls.PasswordBox 类 ”“System.Security.Cryptog- 
raphy.RNGCryptoServiceProvider 类 ”和 “System.Security.SecureString 类 ”主题 。 
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12.0 简介 


线程 (thread) 代表 程序 中 的 单个 执行 逻辑 流程 。 有 些 程序 只 需要 一 个 线程 即 可 高 效 执行 ， 
但 许多 程序 需要 多 个 线程 ， 这 就 是 本 章 将 要 讨论 的 内 容 。.NET 中 的 线程 允许 你 构建 出 快 
速 响应 并 且 高 效 的 应 用 程序 。 许 多 应 用 程序 需要 同时 执行 多 个 动作 〈 比 如 用 户 界面 交互 和 
数据 处 理 ) ， 而 线程 则 提供 了 完成 这 项 工作 的 能 力 。 能 够 允许 你 的 应 用 程序 执行 多 项 任务 
是 应 用 程序 设计 中 一 项 非常 具有 自由 性 但 同时 也 非常 复杂 的 问题 。 一 且 在 应 用 程序 中 采用 
多 个 线程 执行 ， 就 需要 开始 考虑 应 用 程序 中 哪些 数据 需要 受到 保护 以 防止 多 重 并 行 访问 、 
哪些 数据 可 能 导致 线程 出 现 互 相依 赖 从 而 导致 死 锁 (deadlocking， 即 线程 A 拥有 线程 B 正 
在 等 待 的 资源 ， 而 线程 B 拥有 线程 A 正在 等 待 的 资源 ) ， 以 及 如 何 存储 期 望 与 各 个 独立 线 
程 相 关联 的 数据 。 你 还 需要 考虑 处 理 线程 时 的 竞 态 条 件 (race condition), FEA ALE RATE 
两 个 线程 同时 访问 一 个 共享 变量 时 。 两 个 线程 读 取 变 量 并 且 得 到 相同 的 值 ， 然 后 竞争 哪 一 
个 线程 能 够 最 后 写 和 到 共享 变量 中 。 最 后 一 个 写 和 到 变量 的 线程 “取胜 ”， 因 为 它 覆 盖 了 
第 一 个 线程 写 入 的 值 。 你 将 会 探究 这 些 问 题 中 的 一 部 分 ， 从 而 有 助 于 利用 NET Framework 
的 这 一 美妙 的 功能 。 你 也 将 看 到 在 设计 和 创建 多 线程 软件 过 程 中 需要 认真 考虑 的 领域 和 需 
要 关注 的 事项 。 

B} (synchronization) 是 关于 协调 线程 或 进程 之 间 的 活动 ， 并 确保 被 多 个 线程 或 进程 访问 
的 数据 一 直 有 效 。 同 步 允 许 线 程 和 进程 步调 一 致 地 操作 。 理 解 允 许 你 在 程序 中 执行 多 个 线 
程 的 构造 给 了 你 创建 能 够 更 好 地 利用 可 用 资源 、 更 具 扩 展 性 的 应 用 程序 的 能 

JF X (concurrency) 是 关于 程序 的 各 个 方面 的 合作 和 串联 工作 ， 以 实现 目标 。 当 操作 在 你 
的 应 用 程序 中 并 发 运行 时 ， 在 同一 时 间 内 会 发 生 多 个 动作 。 并 发 由 线程 同步 来 促进 。 
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12.1 创建 每 线程 静态 字段 


12.1.1 问题 


静态 字段 默认 在 一 个 应 用 程序 域内 的 多 个 线程 之 间 共 享 。 你 需要 允许 每 个 线程 拥有 自己 的 
非 共享 静态 字段 副本 ， 从 而 使 静态 字段 能 在 每 个 线程 上 更 新 。 


12.1.2 解决 方案 
使 用 ThreadStaticAttribute 将 任意 static 字段 标记 为 线程 间 不 可 共享 的 。 


public class Foo 


( 





[ThreadStaticAttribute()] 
public static string bar = "Initialized string"; 


12.1.3 讨论 

默认 情况 下 ， 静 态 字段 在 同一 应 用 程序 域 中 访问 这 些 字 段 的 所 有 线程 间 共 享 。 为 了 明白 这 
一 点 ， 创 建 一 个 带 有 称 为 bar 的 静态 字段 和 一 个 静态 方法 的 类 来 访问 并 显示 包含 在 该 字段 
中 的 值 。 


private class ThreadStaticField 














{ 
public static string bar = "Initialized string"; 
public static void DisplayStaticFieldValue() 
{ 
string msg = $"{Thread.CurrentThread.GetHashCode()}" + 
$"{ contains static field value of: {ThreadStaticField.bar} "; 
Console.WriteLine(msg); 
} 
} 


接 下 来 ， 创 建 一 个 测试 方法 在 当前 线程 中 和 一 个 新 创建 的 线程 中 访问 该 静态 字段 。 


private static void TestStaticField() 











: ThreadStaticField.DisplayStaticFieldValue(); 
Thread newStaticFieldThread - 
new Thread(ThreadStaticField.DisplayStaticFieldValue); 
newStaticFieldThread.Start(); 
ThreadStaticField.DisplayStaticFieldValue(); 
} 


代码 显示 的 输出 大 致 如 下 所 示 。 
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9 contains static field value of: Initialized string 
10 contains static field value of: Initialized string 
9 contains static field value of: Initialized string 


在 上 述 例子 中 ， 当 前 线程 的 散 列 值 为 9， 而 新 线程 的 散 列 值 为 16。 这 些 值 会 随 系统 的 


不 同 而 不 同 ， 注 意 到 两 个 线程 都 访问 同一 个 静态 bar 字段 。 接 下 来 ， 向 静态 字段 添加 
ThreadStaticAttribute, 





private class ThreadStaticField 


{ 
[ThreadStaticAttribute() ] 
public static string bar = "Initialized string"; 


public static void DisplayStaticFieldValue() 


{ 
string msg = $"{Thread.CurrentThread.GetHashCode()}" + 


$'( contains static field value of: {ThreadStaticField.bar} "; 
Console.WriteLine(msg); 


} 
现在 ， 显 示 的 输出 大 致 如 下 所 示 。 


9 contains static field value of: Initialized string 
10 contains static field value of: 
9 contains static field value of: Initialized string 


注意 ， 新 线程 对 于 静态 字段 bar 返回 nutL。 这 是 预料 之 中 的 。bar 字段 仅 在 访问 它 的 第 一 
个 线程 中 被 初始 化 ， 在 所 有 其 他 线程 中 ， 这 个 字段 被 初始 化 为 nuLL， 因 此 ， 必 须要 在 使 用 
之 前 初始 化 所 有 线程 中 的 bar 字段 。 


要 记 住 ， 在 任何 线程 中 使 用 标记 有 ThreadStaticAttribute 的 静态 字段 之 前 ， 
都 要 进行 初始 化 ， 也 就 是 说 ， 应 当 在 传递 给 Threadstart 委托 的 方法 中 初始 
化 该 字段 。 应 确保 不 使 用 先前 代码 中 的 字段 初始 化 器 来 初始 化 静态 字段 ， 因 
为 仅 有 一 个 线程 会 得 到 该 初始 值 。 


























bar 字段 在 用 于 访问 该 字段 的 第 一 个 线程 之 前 被 初始 化 为 "Initialized string" 字符 串 字 
耐量 。 在 先前 的 测试 代码 中 ，bar 字段 首先 被 访问 ， 因 此 它 在 当前 线程 中 被 初始 化 。 假 设 
你 删除 了 TestStaticField 方法 的 第 一 行 ， 如 下 所 示 。 


private static void TestStaticField() 

















: //ThreadStaticField.DisplayStaticFieldValue(); 
Thread newStaticFieldThread - 
new Thread(ThreadStaticField.DisplayStaticFieldValue); 
newStaticFieldThread.Start(); 
ThreadStaticField.DisplayStaticFieldValue(); 
j 





现在 代码 显示 的 输出 大 致 如 下 所 示 。 


10 contains static field value of: Initialized string 
9 contains static field value of: 


当前 线程 并 疫 有 最 先 访问 bar 字段 ， 因 此 也 不 初始 化 它 。 然 而 ， 当 新 线程 首次 访问 它 时 ， 
对 它 进 行 了 初始 化 。 

要 广 意 ， 添 加 一 个 静态 构造 函数 来 初始 化 标记 有 该 特性 的 静态 字段 仍然 会 遵循 相同 的 行 
为 。 静 态 构 造 国 数 在 每 个 应 用 程序 域 中 仅 运 行 一 次 。 




















12.1.4 参考 


MSDN 文档 中 的 “ThreadstaticAttribute 特性 ”和 “static 修饰 符 (C#)” 主 题 。 
12.2 ”对 类 成 员 提 供 线 程 安全 的 访问 


12.2.1 问题 

你 需要 通过 访问 器 函数 给 内 部 成 员 变量 提供 线程 安全 的 访问 。 

下 面 的 NoSafeMemberAccess 类 展示 了 三 个 方法 : ReadNumericField、IncrementNumericField 
和 ModifyNumericFieLd。 虽 然 三 个 方法 都 访问 了 内 部 numericField 成 员 ， 但 对 于 多 线程 访 
问 而 言 ， 这 些 访问 目前 是 不 安全 的 。 


public static class NoSafeMemberAccess 


( 











7 











private static int numericField = 1; 


public static void IncrementNumericField() 


{ 
++numericField; 
} 
public static void ModifyNumericField(int newValue) 
{ 
numericField = newValue; 
} 


public static int ReadNumericField() => (numericField); 


12.2.2 解决 方案 


NoSafeMemberAccess 可 能 会 用 于 多 线程 应 用 程序 ， 因 此 它 必 须 修改 成 线程 安全 的 。 想 想 
看 ， 如 果 多 线程 同时 调用 IncrementNumericField 方 法 会 发 生 什 么 。 有 可 能 调用 了 两 次 
IncrementNumericField, [fj numericField 仅 更 新 了 一 次 。 为 防止 此 类 事情 发 生 ， 你 通过 创 
建 一 个 能 够 在 代码 临界 区 加 锁 的 对 象 来 修改 这 个 类 。 
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public static class SaferMemberAccess 


{ 


} 
在 sync0bj 对 象 上 使 用 lock 语句 让 你 同步 了 对 numericField 成 员 的 访问 。 这 样 就 会 使 这 


private static int numericField = 1; 
private static object syncObj = new object(); 


public static void IncrementNumericField() 


{ 


lock(syncObj) 
{ 

++numericField; 
} 


} 


public static void ModifyNumericField(int newValue) 


{ 
lock (syncObj) 


numericField - newValue; 


} 
} 
public static int ReadNumericField() 
{ 

lock (syncObj) 

return (numericField); 

} 

} 


个 方法 对 于 多 线程 的 访问 都 是 安全 的 。 


12.2.3 讨论 


可 以 使 用 lock 关键 字 将 一 块 代码 标记 为 临界 区 。lock X fi 5E As BE fi 
程序 控制 之 外 的 实例 上 使 用 ， 否 则 会 导致 死 锁 。 例 如 使 用 this 指针 、 
(typeof(MyClass)) 或 者 一 个 字符 串 文本 ("MyLock" )。 如 果 你 只 是 试 
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类 的 类 型 对 象 
保护 公共 静态 方 


法 中 的 代码 ， 那 么 也 可 使 用 带 有 MethodImpLOptions.Synchronized 值 的 System.Runtime . 
CompilerServices.MethodImpl 特性 来 完成 。 


[MethodImpl (MethodImplOptions.Synchronized)] 
public static void MySynchronizedMethod() 


{ 
} 


在 SaferMemberAccess 示例 中 使 用 诸如 syncobj 之 类 的 对 象 会 产生 同步 问题 。 如 果 你 在 一 个 


能 被 应 用 程序 中 其 他 对 象 访问 的 对 象 或 类 型 上 加 锁 ， 那 么 其 他 对 象 也 可 














相同 的 对 象 。 


能 会 试图 锁定 这 一 








死 锁 是 两 个 共享 相同 资源 的 程序 或 线程 执行 实际 上 相互 阻止 访问 资源 ， 导 致 
两 者 同时 被 阻塞 并 停止 执行 的 情况 。 

以 下 是 死 锁 的 简单 例子 。 

(1) 线程 1 访问 资源 A， 获 得 其 上 的 一 个 锁 。 

(2) 线程 2 访问 资源 B， 获 得 其 上 的 一 个 锁 。 

(3) 线程 1 试图 获得 资源 B， 但 正在 等 待 线程 2 释放 它 。 

(4) 线程 2 试图 获得 资源 A， 但 正在 等 待 线程 1 释放 它 。 

(5) 此 时 这 两 个 线程 被 死 锁 。 















































这 说 明 它 是 锁定 自己 的 糟糕 代码 ， 如 下 所 示 。 


public class DeadLock 


i public void Method1() 
lock(this) 
// 执行 某 些 操作 
} 
} 


当 调用 Method1 时 ， 它 锁定 了 当前 deadlock 对 象 。 不 幸 的 是 ， 任 何 访问 DeadLock 类 的 对 象 
也 可 能 会 锁定 它 ， 如 下 所 示 。 


public class AnotherCls 











{ 
public void DoSomething() 
{ 
DeadLock deadLock = new DeadLock(); 
lock(deadLock) 
Thread thread - new Thread(deadLock.Method1); 
thread.Start(); 
// 此 处 执行 一 些 耗 时 的 任务 
} 
} 
} 


DoSomething 方法 获得 deadlock 对 象 上 的 一 个 锁 ， 然 后 试图 在 另 一 个 线程 上 调用 deadlock 
Xt RAY Methodi 方法 ， 之 后 执行 一 个 耗 时 很 长 的 任务 。 在 长 时 间 的 任务 执行 时 ， 在 
deadLock 对 象 上 的 锁 阻 止 了 Methodi 在 另 一 线程 上 被 调用 。 只 有 当 此 长 时 任务 结束 之 后 ， 
执行 离开 DoSomething 方法 的 临界 区 时 ，Method1 方法 才能 够 获得 这 一 对 象 上 的 锁 。 如 你 所 
见 ， 这 可 能 会 变 成 一 个 在 大 型 应 用 程序 中 执行 跟踪 的 环 手 问题 。 

Jeffrey Richter 采用 了 一 种 相对 简单 的 方法 来 纠正 这 一 情况 ， 他 在 2003 年 1 H MSDN 
Magazine 的 文章 “Safe Thread Synchronization” 中 行 了 详细 的 叙述 。 他 的 解决 方案 是 在 一 
个 要 同步 的 类 中 创建 一 个 私有 字段 。 只 有 对 象 本 身 能 够 获得 该 私有 字段 ， 外 部 对 和 象 或 类 型 
都 不 能 获得 它 。 这 个 解决 方案 也 是 目前 MSDN 文档 中 针对 tock 关键 字 的 推荐 实践 。 可 如 
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下 重新 编写 DeadLock 类 来 解决 这 个 问题 。 


public class DeadLock 


i private object syncObj = new object(); 
public void Method1() 
: lock(syncObj) 
|] 执行 某 些 操作 
} 
} 


现在 ， 在 Deadlock 类 中 锁定 了 内 部 的 sync0bj， 同 时 DoSomething 方法 锁定 了 Deadlock 类 
的 实例 。 这 解决 了 死 锁 条 件 ， 但 DoSomething 方法 仍然 不 应 当 锁 在 公共 类 型 上 。 因 此 ， 可 
如 下 修改 AnotherCls 类 。 

public class AnotherCls 


{ 





private object deadLockSyncObj = new object(); 
public void DoSomething() 


DeadLock deadLock = new DeadLock(); 
lock(deadLockSyncObj) 


Thread thread - new Thread(deadLock.Method1); 
thread.Start(); 
// 此 处 执行 一 些 耗 时 的 任务 





} 


现在 ，AnotherCtLs 类 有 一 个 属于 它 自 己 的 对 象 来 保护 在 DoSomething 中 对 DeadLock 类 的 访 
问 ， 而 不 是 在 公共 类 型 上 加 锁 。 
要 清理 你 的 代码 ， 应 当 停 止 锁 定 任何 对 象 和 类 型 ， 对 于 你 的 类 型 或 对 象 私 有 的 同步 对 象 除 
外 ， 例 如 修正 过 的 DeadLock 类 中 的 sync0bj 对 象 。 本 范例 通过 在 SaferMemberAccess 类 中 
创建 一 个 静态 sync0bj 对 象 来 使 用 这 个 模式 。IncrementNumericField、ModifyNumericField 
和 ReadNumericField 方法 使 用 该 sync0bj 对 numericField 字段 进行 同步 访问 。 注 意 ， 如 果 
你 在 ReadNumericField 方法 读 取 numericField 时 不 需要 锁 ， 那 么 可 以 移 除 这 个 lock 语句 
块 ， 并 简单 地 返回 numericField 字段 中 包含 的 值 。 











在 你 的 代码 中 尽量 减少 临界 区 的 数量 能 够 显著 提高 性 能 。 使 用 你 所 需要 的 数 
量 来 保护 资源 访问 ， 但 不 要 过 多 。 











如 果 你 需要 对 临界 区 的 加 锁 和 解锁 进行 更 多 的 控制 ， 那 么 可 以 试 着 使 用 重 载 的 静态 


Monitor.TryEnter 方法 。 这 些 方法 通过 引入 一 个 超时 值 从 而 具有 更 大 的 灵活 性 。Lock 关键 


字 将 试 
级 的 超 
方法 返 


{ 


mi 


























图 无 限期 地 获取 一 个 临界 区 上 的 锁 ， 但 是 使 用 TryEnter 方法 ， 你 可 以 指定 一 个 毫秒 
时 值 (作为 一 个 整数 ) 或 作为 一 个 TimeSpan 结构 。 如 果 获 得 了 锁 ， 那 么 TryEnter 


|j] true, AURE fatse。 注 意 ， 仅 接受 单个 参数 的 TryEnter 方法 的 重 载 版 本 在 任 
何 时 候 都 不 会 阻塞 。 不 管 是 否 获 得 了 锁 ， 该 方法 都 立即 返回 。 


使 用 Monitor 方法 的 更 新 类 如 例 12-1 所 示 。 
例 12-1: 使 用 Monitor 方法 


public static class MonitorMethodAccess 








private static int numericField = 1; 
private static object syncObj = new object(); 
public static object SyncRoot => syncObj; 


public static void IncrementNumericField() 


{ 
if (Monitor.TryEnter(syncObj, 250)) 
{ 
try 
{ 
++numericField; 
} 
finally 
{ 
Monitor .Exit(sync0bj); 
} 
} 
} 
public static void ModifyNumericField(int newValue) 
{ 
if (Monitor.TryEnter(syncObj, 250)) 
{ 
try 
{ 
numericField = newValue; 
} 
finally 
{ 
Monitor .Exit(sync0bj); 
} 
} 
} 
public static int ReadNumericField() 
{ 
if (Monitor.TryEnter(syncObj, 250)) 
{ 
try 
{ 


return (numericField); 
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} 
finally 


{ 
} 


Monitor.Exit(syncObj); 


} 
return (-1); 


} 
[MethodImpl (MethodImplOptions. Synchronized) ] 
public static void MySynchronizedMethod() 


{ 
j 
j 


注意 ， 使 用 TryEnter 方法 时 ， 你 应 当 总 是 检查 锁 是 否 被 实际 获得 ， 如 果 没 有 获得 ， 代 码 应 
当 等 待 并 重 试 或 者 返回 给 调用 者 。 


此 时 你 可 能 会 认为 ， 所 有 这 些 方法 都 是 线程 安全 的 。 单 独 来 说 ， 它 们 每 一 个 都 是 线 
程 安全 的 ， 但 如 果 你 党 试 调用 它们 并 期 望 两 个 方法 间 的 同步 访问 会 怎样 呢 ? 如 果 
ModifyNumericField 和 ReadNumericField 被 Thread 1 上 的 Class 1 相继 使 用 ， 而 与 此 同时 ， 
Thread 2 上 的 Class 2 正在 使 用 这 些 方法 ， 那 么 加 锁 或 Monitor 调用 将 无 法 阻止 Class 2 在 
Thread 1 读 它 之 前 改变 这 个 值 。 以 下 是 演示 此 过 程 的 一 系列 操作 。 


* Class 1, Thread 1 
FA 10 调用 ModifyNumericField 



































* Class2, Thread 2 
FA 15 调用 ModifyNumericField 
e Class 1, Thread 1 
调用 ReadNumericField, Jf3Xf8 15 而 不 是 10 
。 Class2，Thread 2 
调用 ReadNumericFieLd， 并 获得 期 望 中 的 15 
为 了 解决 这 一 同步 读 写 问题 ， 调 用 方 的 类 需要 管理 交互 。 外 部 类 可 以 通过 使 用 Monitor 类 
在 MonitorMethodAccess 公开 的 同步 对 象 SyncRoot 上 建立 锁 来 达成 此 目的 。 


int num = 0; 
if(Monitor.TryEnter(MonitorMethodAccess.SyncRoot,250)) 


{ 
MonitorMethodAccess.ModifyNumericField(10); 
num = MonitorMethodAccess.ReadNumericField(); 
Monitor.Exit(MonitorMethodAccess.SyncRoot); 

} 


Console.WriteLine(num) ; 


4 REE 2 a 5 RRA HAI RAS, iA PEE: (如 由 Edsger Dijkstra 提 
出 的 银行 家 算法 ) 以 及 阅读 操作 系统 书籍 会 有 助 于 你 思考 创建 代码 的 方式 以 及 它 会 如 何 
反应 。 














12.24 ”参考 


MSDN 文档 中 的 “lock if” "Thread 类 ”和 “Monitor 类 ”主题 ，MSDN Magazine 2003 
年 1 月刊 的 文章 “Safe Thread Synchronization" ; 维基 百科 中 的 “Banker’s algorithm” 和 


“Deadlock Prevention algorithms” 。 


12.3 ”避免 沉默 的 线程 终止 


12.3.4 问题 

如 果 未 处 理 异 常 ， 那 么 从 工作 者 线程 引发 的 异常 会 导致 这 个 线程 被 悄悄 地 终止 。 你 需要 确 
保 处 理 了 所 有 线程 的 所 有 异常 。 如 果 异 常 发 生 在 这 个 新 线程 中 ， 你 希望 处 理 它 并 获得 它 发 
生 的 通知 。 


12.3.2 解决 方案 

你 必须 使 用 try-catch、try-finally 或 try-catch-finally 块 向 传递 给 ThreadStart 委托 的 
方法 添加 异常 处 理 。 完 成 这 项 工作 的 代码 如 例 12-2 所 示 。 

例 12-2: 防止 沉默 的 线程 终止 


public class MainThread 
































{ 
public void CreateNewThread() 
// 创建 新 线程 以 执行 并 行 工 作 
Thread newWorkerThread = new Thread(Worker .DoWork) ; 
newWorkerThread.Start(); 
} 
} 


public class Worker 

{ 
// 由 ThreadStart 委 托 调用 来 执行 并 行 工 作 的 方法 
public static void DoWork () 


{ 





try 





// 此 处 执行 线程 的 工作 


throw new Exception("Boom!"); 
catch(Exception e) 


// 此 处 处 理 线程 异常 
Console.WriteLine(e.ToString()); 


// 不 要 重新 引发 异常 





finally 


// 此 处 执行 线程 清理 
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j 
} 
j 


12.3.3 讨论 


如 有 果 在 一 个 应 用 程序 的 主线 程 中 发 生 了 一 个 未 经 处 理 的 异常 ， 主 线程 会 终止 ， 你 的 整个 应 
m 但 是 ， 生 成 的 工作 者 线程 中 一 个 未 经 处 理 的 异常 只 会 终止 这 一 个 线程 。 
一 情 况 在 发 生 时 不 会 产生 任 可 可 见 的 警告 ， 应 用 程序 将 继续 运行 ， 仿 佛 没 有 任何 事情 发 
可 能 会 因为 损坏 的 数据 或 者 工作 者 线程 不 正确 的 执行 和 交互 而 开始 





























出 现 奇 — 


简单 地 为 Thread 类 的 Start 方法 封装 异常 处 理 程序 将 无 法 捕获 新 生成 线程 的 异常 。Start 
方法 的 调用 发 生 在 当前 线程 的 上 下 文中 ， 而 不 是 在 新 建 线程 上 。 一 旦 线程 被 加 载运 行 ， 它 
会 立即 返回 ， 并 它 不 会 等 待 着 线程 完成 。 因 此 ， 新 线程 中 引发 的 异常 不 会 被 捕获 ， 因 为 
它 对 其 他 任何 线程 都 是 不 可 见 的 。 
如 果 从 catch 块 中 重新 引发 异常 ， 那 么 该 结构 化 的 异常 处 理 程序 的 Finally 块 仍 将 执行 。 
但 是 ， 在 finally 块 结束 后 ， 异 常会 被 再 一 次 引发 。 重 新 引发 的 异常 无 法 被 处 理 ， 并 且 线 
程 终止 。 如 果 finally 块 后 存在 代码 ， 那 么 它 将 不 会 被 执行 ， 因 为 一 个 未 经 处 理 的 异常 发 
生 了 。 

































































绝 不 要 在 线程 内 部 异常 处 理 层 次 中 的 最 高 点 重新 引发 异常 。 因 为 没有 异常 处 
理 程 序 能 够 捕获 这 一 重新 引发 的 异常 ， 所 以 它 会 被 认为 是 未 经 处 理 的 ， 线 程 
将 在 所 有 的 finally 语句 块 执行 后 终止 。 





























如 果 使 用 ThreadPool 和 QueueUserWorkItem 会 怎么 样 呢 ? 该 方法 仍 将 对 你 有 所 帮助 ， 因 为 

peal 的 处 理 代码 。 只 要 确保 你 已 经 建立 了 所 有 finally 块 ， 那么 就 可 
得 到 在 其 他 线程 里 发 生 异 常 的 通知 ， 并 清理 任何 未 清理 的 资源 ， 如 之 前 所 示 。 

为 了 向 你 p WinForms 应 用 程序 提供 最 后 一 次 机 会 的 异常 处 理 程序 ， 你 he 

的 事件 。 第 一 个 事件 是 System. AppDomain. CurrentDomain.UnhandledException 事件 ， 

捕获 当前 ee 中 工作 者 线程 上 的 所 有 未 处 理 的 异常 ， 它 不 捕获 发 生 在 WinForms 

用 程序 的 主 UI 线程 上 的 异常 。 参 见 范例 5.8 ( 即 5.8 节 ) 可 获得 关于 System.AppDomain. 

UnhandledException 事件 的 更 多 信息 。 为 了 捕获 主 UI 线程 上 的 异常 ， 你 还 需要 挂 接 

System.Windows.Forms.Application.ThreadException， 它 会 捕获 主 UI 线程 上 未 经 处 理 的 异 

常 。 有 关 ThreadException 事件 的 更 多 信息 ， 请 参见 范例 5.7 ( 即 5.7 节 )。 


12.3.4 参考 
MSDN 文档 中 的 “Thread 类 ”和 “Exception 类 ”主题 。 
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12.4 在 异步 委托 完成 时 获得 通知 


12.4.1 问题 


你 需要 一 种 方法 ， 用 来 从 异步 调用 的 委托 处 接收 完成 的 通知 。 这 一 方法 必须 允许 代码 继续 
处 理 ， 而 不 需要 在 一 个 循环 中 调用 IsCompleted 或 者 依赖 Waitone 方法 。 由 于 异步 委托 会 








返回 一 个 值 ， 你 必须 能 够 向 调用 方 的 线程 传递 回 这 个 返回 值 。 


12.4.2 ”解决 方案 











使 用 BeginInvoke 方法 来 启动 异步 委托 ， 但 使 用 第 一 个 参数 向 异步 委托 传递 一 个 


如 例 12-3 所 示 。 
f| 12-3: 获得 一 个 匿名 委托 的 完成 通知 


public class AsyncAction 


{ 
public void CallbackAsyncDelegate() 


{ 
AsyncCallback callBack = DelegateCallback; 


AsyncInvoke methodi = TestAsyncInvoke.Method1; 
Console.WriteLine( 


回调 委托 ， 





$"Calling BeginInvoke on Thread (Thread.CurrentThread.ManagedThreadId]"); 
IAsyncResult asyncResult = method1.BeginInvoke(callBack, method1); 








// 此 处 不 需要 轮 循 或 使 用 aitone 方 法 ,因此 返回 到 调用 方法 


return; 











} 


private static void DelegateCallback(IAsyncResult iresult) 


( 


Console.WriteLine( 


$'Getting callback on Thread (Thread.CurrentThread.ManagedThreadId]"); 


AsyncResult asyncResult - (AsyncResult)iresult; 
AsyncInvoke methodi - (AsyncInvoke)asyncResult.AsyncDelegate; 


int retVal = method1.EndInvoke(asyncResult) ; 
Console.WriteLine($"retVal (Callback): {retVal}"); 


} 














该 回调 委托 将 在 异步 委托 完成 处 理 时 在 方法 被 调用 的 线程 上 调用 DelegateCallback 方 
法 。 如 果 该 线程 当前 正在 执行 其 他 代码 ， 回 调 将 等 待 ， 直 到 线程 空 亲 为 止 。 线 程 将 继续 
存在 ， 因 为 系统 知道 一 个 回调 在 挂 起 ， 所 以 你 不 需要 考虑 回调 准备 好 被 调用 时 线程 不 存 





















































在 的 情况 。 











以 下 代码 定义 了 AsyncInvoke 委托 和 异步 调用 的 静态 方法 TestAsyncInvoke.Method1。 
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public delegate int AsyncInvoke(); 


public class TestAsyncInvoke 


{ 
public static int Method1() 
{ 
Console.WriteLine( 
$'"Invoked Methodi on Thread {Thread.CurrentThread.ManagedThreadId}"); 
return (1); 
} 
} 


为 了 运行 异步 调用 ， 可 创建 一 个 AsyncAction 类 的 实例 并 如 下 调用 Cal lbackAsyncDelegate 
方法 。 


AsyncAction aa2 = new AsyncAction(); 
aa2.CallbackAsyncDelegate(); 


该 代码 的 输出 如 下 所 示 。 要 注意 ，Method1 的 线程 ID 是 不 同 的 。 


Calling BeginInvoke on Thread 9 
Invoked Method1 on Thread 10 
Getting callback on Thread 10 
retVal (Callback): 1 


12.4.3 讨论 


代替 使 用 IsCompleted 属性 来 确定 何 时 异步 委托 完成 了 处 理 (或 者 使 用 Waitone 方法 阻塞 

一 段 时 间 ， 同 时 异步 委托 继续 处 理 ) ， 本 范例 使 用 一 个 回调 来 指示 调用 线程 异步 委托 已 完 

成 处 理 并 且 其 返回 值 (ref 参数 值 和 out 参数 值 ) 已 可 用 。 

Lou um E TR. 
高 效 。 在 一 个 循环 中 轮 询 该 属性 时 ， 轮 询 方法 不 能 返回 ， 并 且 人 允许 应 用 程序 继续 进行 处 


ee uM ue ERRARE DIT 
处 理 。 


本 范例 中 的 CallbackAsyncDelegate 方法 利用 异步 委托 的 BeginInvoke 方法 的 第 一 个 参 
它 包 含 了 一 个 当 异 步 委托 完成 处 理 时 将 被 调用 的 回调 方法 。 调 用 
BeginInvoke 后 ， 这 个 方法 可 以 立即 返回 ， 应 用 程序 能 够 继续 处 理 ， 不 必 在 轮 询 循环 中 等 
wu PRI CL HUEE. 

传递 给 BeginInvoke 方法 第 一 个 参数 的 AsyncInvoke 委托 如 下 定义 。 


public delegate void AsyncCallback(IAsyncResult ar) 

创建 该 委托 后 ， 传 和 的 回调 方法 DelegateCallback 将 在 异步 委托 完成 之 后 被 立即 调用 。 
AsyncCallback callBack = new AsyncCallback(DelegateCallback); 

DelegateCallback 不 会 在 BeginInvoke 同一 个 线程 上 运行 ， 而 是 在 来 自 ThreadPool 的 一 个 


线程 上 和 运行。 该 回调 方法 接受 一 个 IAsyncResult 类 型 的 参数 。 你 可 以 在 该 方法 内 将 此 参数 
类 型 转化 为 一 个 AsyncResutt， 然 后 使 用 它 来 获得 关于 已 完成 的 异步 委托 的 信息 ， 比 如 委 
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托 的 返回 值 、 任 何 ref 参数 和 任何 out 参数 值 。 如 果 用 于 调用 BeginInvoke 的 委托 实例 仍 
在 作用 域内 ， 你 可 以 只 向 EndInvoke 方法 传递 IAsyncResuLtt。 此 外 ， 该 对 象 能 够 获得 传递 
给 BeginInvoke 方法 的 第 二 个 参数 的 任意 状态 信息 。 该 状态 信息 可 以 是 任何 对 象 类 型 。 
DelegateCallback 方法 将 IAsyncResult 参数 类 型 转换 为 一 个 AsyncResult 对 象 ， 并 获得 初 

台 调用 的 异步 委托 。 调 用 该 异步 委托 的 EndInvoke 方法 来 处 理 任 何 返 回 值 、ref 参数 或 out 
参数 。 如 果 将 任何 状态 对 象 传递 给 BeginInvoke 方法 的 第 二 个 参数 ， 那 么 可 通过 下 列 代码 
获得 它 。 






























































object state = asyncResult.AsyncState; 


12.4.4 ”参考 


MSDN 文档 中 的 “AsyncCaLLback 委托 ”主题 。 


12.5 ”私有 化 存储 线程 特定 的 数据 


12.5.1 问题 


你 希望 存储 运行 时 发 现 的 线程 特定 的 数据 ， 这 个 数据 应 当 仅 对 运行 在 该 线程 内 的 代码 是 可 
访问 的 。 


12.5.2 ”解决 方案 


在 Thread 类 上 使 用 AllocateDataSlot、AllocateNamedDataSlot 或 GetNamedDataSlot 方 法 
来 预 留 一 个 线程 本 地 存储 (thread local storage, TLS) 槽 。 使 用 TLS， 你 可 以 把 一 个 大 对 
象 存 储 到 线程 内 的 一 个 数据 槽 ， 并 且 在 许多 不 同 的 方法 中 使 用 它 ， 而 不 必 将 此 结构 作为 一 
个 参数 传递 。 

就 本 例 来 说 ， 一 个 名 为 ApplicationData 的 类 代表 了 一 组 可 能 变 得 非常 大 的 数据 。 


public class ApplicationData 


// 应 用 程序 数据 存储 在 此 处 









































在 使 用 这 个 结构 之 前 ， 必 须 在 TLS 里 创建 一 个 数据 槽 来 存储 此 类 。 首 先 ， 调 用 
GetNamedDataSlot 来 获取 appDataSLot。 由 于 appDataSlot 不 存在 ，GetNamedDataSlot 默认 
会 创建 它 。 下 列 代码 创建 了 一 个 ApplicationData 类 的 实例 并 在 名 为 appDataSlot 的 数据 模 
中 保存 它 。 

ApplicationData appData = new ApplicationData(); 

Thread. SetData(Thread.GetNamedDataSlot("appDataSlot"), appData); 


每 当 你 需要 此 类 时 ， 都 可 以 通过 调用 Thread.GetData 来 获取 它 。 下 面 的 代码 从 名 为 
appDataSlot 的 数据 槽 中 获得 appData 结构 。 
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据 模 


ApplicationData storedAppData = (ApplicationData)Thread.GetData( 


Thread.GetNamedDataSlot("appDataSlot")); 


此 时 ，storedAppData 结构 可 被 读 取 或 修改 。 在 storedAppData 上 执行 动作 后 ， 必 须 将 其 放 
回 名 为 appDataSlot 的 数据 槽 中 。 




















Thread.SetData(Thread.GetNamedDataSlot("appDataSlot"), storedAppData); 


一 旦 应 用 程序 完成 了 对 这 个 数据 的 使 用 ， 那 么 可 通过 下 列 方法 调用 从 内 存 中 释放 该 数 


o 


Thread.FreeNamedDataSlot("appDataSlot"); 
例 12-4 中 的 HandleClass 类 展示 了 如 何 使 用 TLS 存储 结构 。 
例 12-4: 使 用 TLS 存储 结构 


public class HandleClass 


{ 











public static void Run() 


{ 





























// 创建 结构 实例 并 将 其 存储 在 命名 数据 槽 中 
ApplicationData appData = new ApplicationData(); 
Thread. SetData(Thread.GetNamedDataSlot("appDataSlot"), appData); 




















// 调用 另 一 个 将 会 使 用 此 结构 的 方法 
HandleClass.MethodB(); 

















// FEM, PERU BES 
Thread.FreeNamedDataSlot("appDataSlot"); 





j 


public static void MethodB() 
{ 





// 从 命名 数据 槽 中 获得 此 实例 
ApplicationData storedAppData = (ApplicationData)Thread.GetData( 
Thread.GetNamedDataSlot("appDataSlot")); 





// 修改 ApplicationData 


// 完成 数据 修改 后 ,将 变化 保存 回 命名 的 数据 模 
Thread.SetData(Thread.GetNamedDataSlot("appDataSlot"), 
storedAppData); 














Ln 








// 调用 另 一 个 将 会 使 用 此 结构 的 方法 
HandleClass.MethodC(); 








} 


public static void MethodC() 





// 从 命名 数据 槽 中 获得 实例 
ApplicationData storedAppData = 
(ApplicationData)Thread.GetData(Thread.GetNamedDataSlot("appDataSlot")); 





// 修改 数据 























// 完成 数据 修改 后 ,将 变化 保存 回 命 名 的 数据 模 
Thread.SetData(Thread.GetNamedDataSlot("appDataSlot"), storedAppData) ; 


} 





} 


12.5.3 讨论 


线程 本 地 存储 可 以 方便 地 存储 跨 方 法 调用 可 用 的 数据 ， 无 需 用 户 向 方法 传人 结构 ， 甚 至 不 
需要 了 解 实际 是 在 何 处 创建 的 结构 。 


在 一 个 命名 TLS 数据 槽 中 存储 的 数据 仅 对 那个 线程 可 用 ， 其 他 线程 无 法 访问 另 一 个 线程 中 
的 命名 数据 槽 。 在 这 个 数据 槽 中 存储 的 数据 在 线程 内 的 任何 地 方 均 可 访问 。 这 一 设 定 实质 
上 令 该 数据 成 为 线程 全 局 数据 。 你 应 该 意识 到 TLS 数据 槽 是 一 个 有 限 的 资源 ， 随 平台 的 不 
同 而 变化 。 

要 创建 一 个 命名 数据 槽 ， 可 使 用 静态 Thread.GetNamedDataSlot 方法 。 该 方法 接受 一 个 定义 
数据 槽 名 称 的 单个 参数 name。 名 称 应 该 是 唯一 的 ， 如 果 已 存在 一 个 同名 的 数据 槽 ， 该 数据 
槽 的 内 容 将 被 返回 ， 而 不 会 创建 一 个 新 的 数据 槽 。 这 个 行为 会 默默 地 发 生 ， 不 会 引发 异常 
或 错误 代码 ， 通 知 你 正在 使 用 别处 已 创建 的 数据 槽 。 为 了 确保 你 使 用 的 是 唯一 的 数据 模 ， 
可 使 用 Thread.AllocateNamedDataSlot 方法 。 如 果 一 个 同名 的 数据 槽 已 经 存在 ， 该 方法 会 
引发 一 个 System.ArgumentException。 否 则 ， 它 的 操作 与 GetNamedDataSlot 方法 类 似 。 


请 注意 ， 在 进程 中 的 每 个 线程 上 都 会 创建 这 个 已 命名 的 数据 槽 ， 而 不 仅仅 是 在 调用 这 个 方 
法 的 线程 上 。 但 是 ， 这 一 事实 项 多 只 是 给 你 带 来 一 点 不 便 ， 因 为 每 个 数据 模 中 的 数据 都 只 
能 被 包含 它 的 线程 访问 。 此 外 ， 如 果 在 一 个 单独 的 线程 上 创建 一 个 同名 数据 模 ， 并 且 你 
这 个 名 称 在 当前 线程 上 调用 GetNamedDataStot， 任 何 线程 上 的 任何 数据 模 中 的 数据 都 不 会 
遭 到 破坏 。 

GetNamedDataSlot 返回 一 个 用 于 访问 数据 覃 的 LocalDataStoreSlot 对象。 注意， 这 个 类 不 
能 通过 使 用 new 关键 字 来 创建 ， 必 须 通 过 Thread 类 上 的 AllocateDataSlot 或 Allocate- 
NamedDataSlot 方法 之 一 来 创建 。 


要 在 这 个 数据 槽 中 存储 数据 ， 可 使 用 静态 Thread.SetData 方法 ， 这 个 方法 接受 传递 给 data 
参数 的 对 象 ， 并 将 其 存储 在 由 dataslot 参数 定义 的 数据 槽 中 。 


静态 Thread.GetData 方 法 取 回 存储 在 数据 槽 中 的 对 象 ， 这 个 方法 取 回 通过 Thread. 
GetNamedDataSlot 方法 创建 的 LocalDataStoreSlot 对 象 。GetData 方法 然后 返回 存储 在 该 特 
定数 据 槽 中 的 对 象 。 要 注意 的 是 ， 返 回 的 对 象 在 使 用 之 前 必须 强制 转换 成 它 的 原始 类 型 。 


静态 方法 Thread. FreeNamedDataSlot 会 释放 与 命名 数据 槽 相关 的 内 存 。 这 个 方法 接受 
数据 槽 的 名 称 作为 一 个 字符 串 ， 然 后 释放 与 该 数据 槽 相关 的 内 存 。 要 记 住 ， 当 使 用 
GetNamedDataSlot 创建 数据 槽 时 ， 在 该 进程 中 其 他 所 有 运行 线程 上 ， 也 会 创建 一 个 数据 槽 。 
使 用 GetNamedDataslot 创建 数据 槽 真 的 不 是 一 个 问题 ， 如 果 同 名 数据 槽 存在 ， 那 么 会 返回 
一 个 引用 该 数据 槽 的 LocalDataStoreSlot 对 象 ， 不 会 创建 新 数据 槽 ， 而 该 数据 槽 中 的 原始 
数据 也 不 会 损坏 。 


当 使 用 FreeNamedDataSlot 方法 时 ， 这 种 情况 就 会 成 为 一 个 问题 。 这 个 方法 会 释放 所 有 线 
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程 中 与 传人 的 数据 槽 名 关联 的 内 存 ， 而 不 仅仅 是 调用 所 处 的 线程 。 在 所 有 线程 结束 使 用 该 
数据 槽 中 的 数据 之 前 释放 数据 槽 可 能 会 给 应 用 程序 带 来 灾难 性 的 后 果 。 

解决 这 个 问题 的 方法 之 一 是 根本 不 要 调用 FreeNamedDataSlot 方法 。 当 一 个 线程 终止 时 ， 
TLS 中 的 所 有 数据 槽 会 自动 释放 。 不 调用 FreeNamedDataSlot 的 副作用 是 这 个 数据 槽 会 被 
一 直 占 用 ， 直 到 垃圾 收集 器 确定 创建 数据 槽 的 线程 已 经 结束 并 且 数 据 槽 可 被 释放 为 I 上 。 


如 果 你 在 编译 期 间 知 道 代 码 所 需 TLS 覃 的 数量 ， 可 以 考虑 在 类 的 一 个 静态 字段 上 使 用 
ThreadStaticAttribute 来 建立 类 似 TLS 的 存储 。 
























































12.5.4 ”参考 


MSDN 文档 中 的 “Thread Local Storage: Thread Relative Static Fields and Data Slots”“Thread 
StaticAttribute 特性 ”和 “Thread 类 ”主题 。 


12.6 ”使 用 信号 量 允 许 资源 的 多 重 访问 


12.6.1 问题 
你 拥有 一 个 资源 ， 和 希望 在 给 定时 间 内 只 有 一 定数 量 的 客户 可 以 访问 它 。 


126.2 ”解决 方案 

使 用 信号 量 来 实现 对 资源 的 资源 计数 访问 。 例 如 ， 如 果 你 有 一 台 Xbox One 和 一 套 《 光 环 
5) (Halo 5) 的 副本 (资源) 以 及 一 位 急于 舒缓 压力 的 开发 人 员 (用 户 )， 那 么 必须 同步 对 
Xbox One 的 访问 。 因 为 Xbox One 最 多 有 8 个 控制 器 ， 所 以 在 给 定时 间 内 一 次 最 多 能 有 8 
个 人 一 起 玩 游戏 。 游 戏 规则 是 ， 当 一 个 人 的 角色 死亡 后 ， 就 得 让 出 控制 器 。 

为 此 ， 可 以 如 下 使 用 一 个 名 为  Xboxone 的 Semaphore 创建 一 个 名 为 Halo5Session 的 类 。 


public class Halo5Session 














// 一 个 模拟 有 限 资 源 池 的 信号 量 


private static Semaphore _XboxOne; 
为 了 完成 这 项 工作 ， 你 需要 调用 Halo5Session 类 上 的 Play 方法 ， 如 例 12-5 所 示 。 
il 12-5. Play 方法 


public static void Play() 
{ 
// 一 台 Xbox0ne 最 多 有 8 个 控制 器 端口 ,所 以 8 个 人 可 以 同时 游戏 
// 我 们 使 用 8 作为 最 大 值 ,9 作为 初始 值 ,因为 我 们 希望 玩家 
// 首先 排队 以 等 待 Xboxone 启 动 并 加 载 游戏 
// 
using ( XboxOne = new Semaphore(0, 8, "XboxOne")) 


{ 









































using (ManualResetEvent GameOver = 
new ManualResetEvent(false)) 


{ 
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// 
// 13 个 玩家 登入 以 等 待 游戏 
// 
List«XboxOnePlayer.PlayerInfo» players = 
new List«XboxOnePlayer.PlayerInfo»() { 
new XboxOnePlayer.PlayerInfo { Name="Igor" ,Dead=GameOver}, 
new XboxOnePlayer.PlayerInfo { Name="AxeMan",Dead=GameOver}, 
new XboxOnePlayer.PlayerInfo { Name="Dr. Death", 
Dead=GameOver}, 
new XboxOnePlayer.PlayerInfo { Name="HaPpyCaMpEr", 
Dead=GameOver}, 
new XboxOnePlayer.PlayerInfo { Name="Executioner", 
Dead=GameOver}, 
new XboxOnePlayer.PlayerInfo { Name="FragMan" ,Dead=GameOver}, 
new XboxOnePlayer.PlayerInfo { Name="Beatdown", 
Dead=GameOver}, 
new XboxOnePlayer.PlayerInfo { Name-"Stoney",Dead-GameOver], 
new XboxOnePlayer.PlayerInfo { Name-"Pwned",Dead-GameOver), 
new XboxOnePlayer.PlayerInfo { Name="Big Dawg", 
Dead=GameOver}, 
new XboxOnePlayer.PlayerInfo { Name="Playa" ,Dead=GameOver}, 
new XboxOnePlayer.PlayerInfo { Name="BOOM" ,Dead=GameOver}, 
new XboxOnePlayer.PlayerInfo { Name="Mr. Mxylplyx", 
Dead=GameOver } 











5 

foreach (XboxOnePlayer.PlayerInfo player in players) 
{ 

Thread t = new Thread(XboxOnePlayer.JoinIn); 

// 将 名 称 保存 在 线程 上 

t.Name = player.Name; 

// 启动 玩家 

t.Start(player); 
} 
// 等 待 Xbox0ne 开 机 并 加 载 HaLto5(3 秒 钟 ) 
Console.WriteLine("XboxOne initializing..."); 


Thread.Sleep(3000); 
Console.WriteLine( 
"Halo 5 loaded & ready, allowing 8 players in now..."); 


// Xboxone 拥 有 全 部 信号 量 计数 

// 我 们 调用 ReLease(8) 以 开放 8 个 槽 并 且 
// 允许 等 待 的 玩家 进入 Xboxone( 信 号 量 ) 
// 最 多 一 次 8 个 人 

// 

_XboxOne.Release(8); 


// ERRER 


GameOver .WaitOne(); 
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Play 方法 做 的 第 一 件 事 就 是 创建 一 个 最 多 具有 8 个 资源 数 和 一 个 名 称 _XboxOne 的 新 信号 
量 。 这 个 信号 量 将 被 所 有 玩家 线程 使 用 ， 以 获得 对 游戏 的 访问 。 创 建 一 个 名 为 GameOver 的 
ManualResetEvent 以 跟踪 游戏 何 时 结束 。 


为 了 模拟 开发 者 ， 你 为 每 个 玩家 创建 一 个 线程 ， 带 有 它 自 己 的 XboxonePlayer .PlayerInfo 
类 实例 ， 其 中 包含 玩家 的 姓名 和 在 PlayerInfo 的 Dead 事件 中 的 对 用 于 标识 玩家 死亡 的 原 
始 ManualResetEvent 实例 GameOver 的 引用 。 创 建 线程 使 用 了 ParameterizedThreadStart 委 
托 ， 它 在 构造 函数 中 接受 要 在 新 线程 上 执行 的 方法 ， 同 时 允许 你 直接 向 Thread. start 方法 
的 新 重 载 版 本 传递 数据 对 象 。 


玩家 准备 好 开始 之 后 ，Xbox Em 便 开 始 “ 初 始 化 "， 然 后 在 信号 量 上 调用 Release， 打 开 玩 
家 线程 可 获取 的 8 AM, Hh 然后 等 待 ， 直 到 它 从 玩家 的 Dead 事件 激发 中 检测 到 游戏 结束 为 止 。 


玩家 在 独立 的 线程 上 初始 化 ， 然 后 运行 JoinIn 方法 ， 如 例 12-6 所 示 。 首 先 ， 它 们 通过 
名 称 打开 Xbox One 信号 量 ， 并 获取 传递 给 线程 的 数据 。 一 旦 拥有 了 信号 量 ， 它 们 就 调用 
WaitOne 排队 等 候 游 戏 。 一 日 最 初 的 8 个 槽 被 打开 或 者 有 玩家 和 死亡， 就 对 Waitone 的 调用 解 
除 阻塞 ,玩家 可 以 玩 一 段 时 间 游 戏 ， 直 到 角色 死亡 为 止 。 一 旦 玩家 角色 死亡 ， 他 们 便 调用 
信号 量 上 的 Release， 表 示 他 们 的 槽 现在 打开 了 。 如 果 信 号 量 达到 最 大 资源 数量 ， 就 设置 
GameOver 事件 。 


例 12-6; JoinIn 方法 
public class XboxOnePlayer 
{ 










































































public class PlayerInfo 


public ManualResetEvent Dead {get; set;} 
public string Name {get; set;} 


j 


// 玩家 死亡 模式 
private static string[] deaths = new string[7]{"bought the farm", 
"choked on a rocket", 
"shot their own foot", 
"been captured", 
"fallen to their death", 
"died of lead poisoning", 
"failed to dodge a grenade", 
5 


/// <summary> 

/// 线程 国 数 

/// </summary> 

/// «param name="info">PlayerInfo 数 据 项 </param> 
public static void JoinIn(object info) 





// 通过 名 称 打开 信号 量 ,为 了 让 我 们 操作 它 


using (Semaphore XboxOne = Semaphore.OpenExisting("XboxOne" ) ) 





// 获得 数据 对 象 
PlayerInfo player = (PlayerInfo)info; 
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fr Play 方法 时 ， 将 产生 类 似 以 下 的 输 日 


// 每 个 玩家 通知 Xbox0ne 他 们 想 进 行 游戏 


Console.WriteLine($"{player.Name} is waiting to play!"); 


// 等 待 Xboxone( 信 号 量 ) 直 到 让 玩家 获得 
// 一 个 控制 器 
XboxOne.WaitOne(); 





// Xboxone 选 择 了 此 玩家 

// (或 者 说 信号 允许 了 访问 资源 ……) 

Console.WriteLine($"{player.Name} has been chosen 
$'"Welcome to your doom {player.Name}. >:)"); 





// 确定 一 个 随机 值 ,用 于 确定 玩家 持续 游戏 了 多 久 
System.Random rand = new Random(500); 
int timeTillDeath = rand.Next(100, 1000); 


// 模拟 玩家 忙于 玩 游戏 ,直到 角色 死亡 为 止 
Thread.Sleep(timeTillDeath); 








// 确定 玩家 角色 是 如 何 死亡 的 
rand = new Random(); 
int deathIndex = rand.Next(6); 





// 通知 此 玩家 已 结束 游戏 并 跳 过 

















Console.WriteLine($"{player.Name} has {_deaths[deathIndex]} " + 


"and gives way to another player"); 














to play. + 


// 如 果 所 有 的 端口 都 打开 了 ,所 有 人 都 已 玩 过 了 游戏 ,游戏 结束 





int semaphoreCount = XboxOne.Release(); 
if (semaphoreCount == 3) 


{ 
Console.WriteLine("Thank you for playing, the game has ended."); 
// 设置 玩家 的 Dead 事 件 
player .Dead.Set(); 

} 


} 





co 
o 


Igor is waiting to play! 

AxeMan is waiting to play! 

Dr. Death is waiting to play! 
HaPpyCaMpEr is waiting to play! 
Executioner is waiting to play! 
FragMan is waiting to play! 
Beatdown is waiting to play! 
Stoney is waiting to play! 
Pwned is waiting to play! 

Big Dawg is waiting to play! 
Playa is waiting to play! 
XboxOne initializing... 

BOOM is waiting to play! 
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Mr. Mxylplyx is waiting to play! 

Halo 5 loaded & ready, allowing 8 players in now... 

Stoney has been chosen to play. Welcome to your doom Stoney. >:) 
Executioner has been chosen to play. Welcome to your doom Executioner. >:) 
Beatdown has been chosen to play. Welcome to your doom Beatdown. >:) 

Pwned has been chosen to play. Welcome to your doom Pwned. >:) 

Playa has been chosen to play. Welcome to your doom Playa. >:) 

HaPpyCaMpEr has been chosen to play. Welcome to your doom HaPpyCaMpEr. >:) 
Big Dawg has been chosen to play. Welcome to your doom Big Dawg. >:) 
FragMan has been chosen to play. Welcome to your doom FragMan. >:) 

Playa has been captured and gives way to another player 

Stoney has been captured and gives way to another player 

Pwned has been captured and gives way to another player 

Big Dawg has been captured and gives way to another player 

Mr. Mxylplyx has been chosen to play. Welcome to your doom Mr. Mxylplyx. »:) 
BOOM has been chosen to play. Welcome to your doom BOOM. »:) 

FragMan has was captured and gives way to another player 

Dr. Death has been chosen to play. Welcome to your doom Dr. Death. »:) 
HaPpyCaMpEr has been captured and gives way to another player 

Igor has been chosen to play. Welcome to your doom Igor. »:) 

Beatdown has been captured and gives way to another player 

Executioner has been captured and gives way to another player 

AxeMan has been chosen to play. Welcome to your doom AxeMan. »:) 

BOOM has died of lead poisoning and gives way to another player 

Thank you for playing, the game has ended. 

Mr. Mxylplyx has died of lead poisoning and gives way to another player 


12.6.3 it 


信号 量 主 要 用 于 资源 计数 ， 并 且 命 名 信号 量 可 用 于 跨 进 程 使 用 (因为 它们 基于 内 核 信号 量 
对 象 )。 对 于 许多 .NET 开发 人 员 而 言 ， 在 他 们 意识 到 跨 进程 (cross-process) 也 即 意 味 着 
跨 AppDomain (cross-AppDomain) 之 前 ， 可 能 不 会 对 跨 进程 表现 出 太 大 的 兴趣 。 如 果 你 
在 创建 额外 的 AppDomain 来 包含 你 动态 加 载 但 不 希望 在 自己 的 主 AppDomain 的 整个 生命 期 
中 都 保留 的 程序 集 ， 那 么 信号 量 有 助 于 你 跟踪 du aE de 控制 一 定数 量 的 访 
问 者 在 许多 情景 中 都 是 很 有 用 的 〈 套 接 字 编 程 、 自 定义 线程 地 ， 等 等 ) 。 


12.6.4 84 


MSDN 文档 中 的 “Semaphore”“ManualResetEvent” 和 “ParameterizedThreadStart” 主 题 。 


12.7 ”使 用 互 斥 量 同步 多 个 进程 


12.7.1 问题 
你 有 两 个 进程 或 AppDomain 在 运行 具有 需要 协调 的 行为 的 代码 。 


12.7.2 ”解决 方案 


要 进行 协调 ， 可 使 用 一 个 命名 Mutex 作为 一 个 通用 的 信号 机 制 。 命 名 Mutex 可 以 从 运行 于 








~ 



































不 同 进程 或 AppDomaiin 的 代码 进行 访问 。 
这 样 做 很 有 用 的 一 种 情况 是 ， 你 正在 使 用 共享 内 存在 进程 间 进 行 通 信 。 本 范例 中 展示 


的 SharedMemoryManager 类 通过 建立 可 用 于 在 进程 间 传 递 可 序列 化 对 象 的 一 段 共享 内 存 
来 展示 实际 使 用 的 命名 Mutex。“ 服 务 器 ”进程 创建 一 个 SharedMemoryManager 实例 ， 它 





建立 共 








t 享 内 存 并 作为 最 初 的 拥有 者 创建 Mutex。“ 客 户 端 ”进程 然后 同样 创建 了 一 个 








SharedMemoryManager 实例 ， 查 找 共 S due e 一 旦 连接 建立 ,“ 客 户 端 ” 进 程 就 





开始 接收 可 序列 化 的 对 象 并 通过 等 待 “服务 器 ”进程 创建 的 Mutex 来 等 待 一 个 对 象 发 出 。 


< 服务 器 ”进程 将 一 个 可 序列 化 对 象 序列 化 到 共享 内 存 中 ， 并 释放 utex。 然 后 它 理 











等 待 ， 以 便当 “客户 端 ” 完 成 接收 对 象 后 ， 它 能 够 释放 Mutex 并 将 控制 权 交还 给 “服务 
E 在 Mutex 上 等 待 的 “客户 端 ” 进 程 然 后 反 序 列 化 来 自 共 享 内 存 的 对 象 并 释放 Mutex。 





在 示例 











中 ， 你 将 发 送 如 下 的 Contact 结构 。 


[StructLayout(LayoutKind.Sequential)] 
[Serializable()] 
public struct Contact 


( 


} 


public string _name; 
public int _age; 


发 送 Contact 的 “服务 器 ”进程 代码 如 下 所 示 。 
// 创建 初始 共享 内 存 管理 器 以 进行 设置 


using(SharedMemoryManager<Contact> sm = 


( 























new SharedMemoryManager«Contact»( "Contacts" ,8092)) 
// 这 是 发 送 方 进程 
// 启动 第 二 个 进程 以 继续 


string processName = Process.GetCurrentProcess().MainModule.FileName; 
int index = processName.IndexOf("vshost"); 

if (index != -1) 

{ 





string first = processName.Substring(0, index); 
int numChars = processName.Length - (index + 7); 
string second = processName.Substring(index + 7, numChars); 


processName = first + second; 
Process receiver = Process.Start( 
new ProcessStartInfo( 
processName, 
"Receiver")); 


/ 等 待 5 秒 
Thread.Sleep( 5000) ; 


// 创建 一 个 contact 
Contact man; 

an._age = 23; 
man._name = "Dirk Daring"; 
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// 通过 共享 内 存 将 其 发 送 至 























= 


其 他 进程 


sm.SendObject(man); 


} 
接收 Contact 的 


“客户 端 ” 进 程 代码 如 下 所 示 。 











// 创建 初始 共享 内 存 管理 器 以 进行 设置 
using(SharedMemoryManager<Contact> sm = 
new SharedMemoryManager<Contact>("Contacts" ,8092)) 


{ 











[| 一 旦 contact 发 送 过 来 后 获取 它 


Contact c = (Contact)sm.ReceiveObject(); 





// 将 它 写 到 控制 台 ( 或 者 到 一 个 数据 库 ……) 


Console.WriteLine("Contact {0} is {1} years old.", 





C. name, c. age); 





1/ 等待 5 各 


Thread. 


} 


Sleep(5000); 





通常 的 工作 方式 是 ， 一 个 进程 使 用 System. I0. MemoryMappedFile 创建 一 段 分 页 文件 支持 的 





共享 内 存 。 你 可 
中 建立 。 此 构造 





以 在 例 12-7 中 看 到 MemoryMappedFile 在 SharedMemoryManager 的 构造 函数 
函数 接受 一 个 名 称 作为 共享 内 存 的 名 称 ， 以 及 要 分 配 的 共享 内 存 块 的 基础 








大 小 。 这 是 基础 大 小 ， 因 为 SharedMemoryManager 必须 额外 分 配 一 点 ， 以 保持 跟踪 通过 组 
冲 区 移动 的 数据 。 


例 12-7: 构造 函数 


public Shar 
{ 

/ 只 能 

a (!ty 

thr 


if (str 
thr 


if (sha 
thr 


// 设置 


Name = 


// 保存 
SharedM 


// 建立 共 


MemMapp 





// 建立 


edMemoryManager(string name,int sharedMemoryBaseSize) 


够 为 可 序列 化 的 对 象 构建 
peof(TransferItemType).IsSerializable) 


ow new ArgumentException( 
$"Object {typeof(TransferItemType)} is not serializeable."); 





ing.IsNullOrEmpty(name)) 
ow new ArgumentNullException(nameof(name)); 


redMemoryBaseSize «- 0) 
ow new ArgumentOutOfRangeException(nameof(sharedMemoryBaseSize), 
"Shared Memory Base Size must be a value greater than zero"); 


区 段 的 名 称 


name; 








基础 大 小 


emoryBaseSize = sharedMemoryBaseSize; 


享 内 存 
edFile = MemoryMappedFile.CreateOrOpen(Name, MemoryRegionSize) ; 


Xl 





互 斥 量 





MutexForSharedMem = new Mutex(true, MutexName) ; 


} 


通过 共享 内 存 发 送 一 个 对 象 的 代码 包含 在 Sendobject 方法 中 ， 如 例 12-8 所 示 。 首 先 ， 它 
检查 要 发 送 的 对 象 是 否 可 序列 化 ， 办 法 是 通过 检查 对 象 类 型 上 的 IsSertalizable 属性 。 如 
有 果 对 象 可 序列 化 ， 则 会 将 一 个 带 有 可 序列 化 对 象 大 小 的 整数 和 可 序列 化 对 象 内 容 写 到 共享 
内 存 区 。 然 后 ，Mutex 被 释放 ， 指 示 在 共享 内 存 中 有 一 个 对 象 。 它 随后 再 次 等 待 Mutex， 直 
到 “客户 端 ” 已 经 接收 到 这 个 对 象 为 止 。 
例 12-8; SendObject 方法 

public void SendObject(TransferItemType transferObject) 





// 创建 内 存 流 ,初始 大 小 
using (MemoryStream ms = new MemoryStream()) 
{ 

// 获得 一 个 用 于 序列 化 的 格式 化 器 

BinaryFormatter formatter = new BinaryFormatter(); 

try 

{ 

// 将 对 象 序列 化 到 流 中 


formatter .Serialize(ms, transferObject); 





|] 获得 序列 化 对 象 的 字 市 
byte[] bytes = ms.ToArray(); 


// 检查 该 对 象 大 小 
if(bytes.Length + sizeof(Int32) > MemoryRegionSize) 


{ 
string msg = 
s"{typeof(TransferItemType)} object instance serialized" + 
$'to {bytes.Length} bytes which is too large for the shared "+ 
$"memory region"; 
throw new ArgumentException(msg, nameof(transferObject)); 
} 


// 写 入 到 共享 内 存 区 
using (MemoryMappedViewStream stream = 
MemMappedFile.CreateViewStream()) 




















{ 
BinaryWriter writer = new BinaryWriter(stream) ; 
writer .Write(bytes.Length); // 写 入 大 小 
writer.Write(bytes); // BAHE 
} 
} 
finally 
{ 






































// 通知 其 他 使 用 互 斥 量 的 进程 
// 要 进行 接收 处 理 


MutexForSharedMem.ReleaseMutex(); 








// 等 待 其 他 进程 已 完成 接收 的 信号 
// 然后 我 们 能 够 继续 
MutexForSharedMem.WaitOne(); 
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j 


例 12-9 中 所 示 的 ReceiveObject 方法 允许 客户 端 等 待 直 至 共 





它 读 取 可 序列 化 对 象 的 大 小 ， 并 将 其 序列 化 到 一 个 托管 对 象 。 之 后 ， 


送 方 知道 可 以 继续 工作 。 





例 12-9: ReceiveObject 方法 
public TransferItemType ReceiveObject() 























// 等 待 互 斥 量 , 直 到 发 送 方 将 一 个 对 象 放 和 人 队列 


MemMappedFile.CreateViewStream()) 


BinaryReader reader - new BinaryReader(stream); 
int objectLength - reader.ReadInt32(); 
serializedObj = reader.ReadBytes(obj 


ectLength); 


using (MemoryStream ms - new MemoryStream(serializedObj)) 





BinaryFormatter formatter - new BinaryFormatter(); 





item - (TransferItemType)formatter.Deserialize(ms); 




















互 斥 量 通 知 我 们 已 接收 到 对 象 


MutexForSharedMem.ReleaseMutex(); 





{ 
MutexForSharedMem.WaitOne(); 
// 从 共享 内 存 中 获得 对 象 
byte[] serializedObj = null; 
using (MemoryMappedViewStream stream = 
{ 
} 
|] 使 用 对 象 字 节 数 据 创 建 内 存 流 
{ 
// 建立 一 个 二 进 制 格 式 化 器 
// 获得 对 象 以 返回 
TransferItemType item; 
try 
} 
finally 
// 使 用 
} 
// 返回 接收 的 对 象 
return item; 
} 
j 


12.7.3 讨论 


Mutex 设计 用 于 给 单个 资源 提供 互 斥 访问 ( 
命名 Monitor， 其 中 通过 在 Mutex 上 等 
o 如 








释放 Mutex 而 “ 退出 ” 








果 一 个 拥有 Mutex 的 线程 


ps uM 
待 成 为 所 有 者 而 “进入 ”， 通 过 六 


结束 ， ae Mutex 会 





kt 享 内存 中 存在 一 个 对 象 ， 然 后 





它 释放 Mutex， 让 发 


Mutex n PBA A H 跨 进 程 的 


等 待 它 的 下 一 线程 
AH 动 释放 。 











使 用 Mutex 比 使 用 Monitor 要 慢 ， 因 为 Monitor 是 一 种 纯 托 管 的 构造 ， 而 
Mutex 则 基于 Mutex 内 核对 象 。Mutex 不 能 像 Monitor 那样 是 “脉冲 式 的 ”， 
但 它 可 跨 进程 使 用 ， 而 Monitor 不 能 。 最 后 ，Mutex 基于 WaitHandle， 所 以 
它 能 够 与 其 他 从 WaitHandle 派生 而 来 的 对 象 一 起 被 等 待 ， 例 如 Semaphore 或 
事件 类 。 














例 12-10 中 完整 地 列 出 了 SharedMemoryManager 类 。 


例 12-10: SharedMemoryManager 类 
/// <summary> 


/// 通过 共享 内 存 来 发 送 对 象 ， 

/// 使 用 互 斥 量 来 同步 访问 共享 内 存 的 类 

/// </summary> 

public class SharedMemoryManager<TransferItemType> : IDisposable 


{ 





#region Private members 
private bool disposed = false; 
#endregion 


#region Construction / Cleanup 
public SharedMemoryManager(string name,int sharedMemoryBaseSize) 


{ 





// 只 能 够 为 可 序列 化 的 对 象 构 建 
if (!typeof(TransferItemType).IsSerializable) 
throw new ArgumentException( 
$"Object {typeof(TransferItemType)} is not serializeable."); 


if (string.IsNullOrEmpty(name)) 
throw new ArgumentNullException(nameof(name)); 


if (sharedMemoryBaseSize «- 0) 
throw new ArgumentOutOfRangeException("sharedMemoryBaseSize", 
"Shared Memory Base Size must be a value greater than zero"); 


// 设置 区 段 的 名 称 


Name = name; 








// 保存 基础 大 小 


SharedMemoryBaseSize = sharedMemoryBaseSize; 





// 建立 共享 内 存 区 
MemMappedFile = MemoryMappedFile.CreateOrOpen(Name, MemoryRegionSize) ; 








// 建立 互 斥 量 
MutexForSharedMem = new Mutex(true, MutexName) ; 


} 


~SharedMemor yManager () 
{ 
// 确保 关闭 


Dispose(false); 
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public void Dispose() 


{ 
Dispose(true); 
GC.SuppressFinalize(this); 
} 
private void Dispose(bool disposing) 
{ 
// 检查 Dispose 是 否 已 被 调用 
if (!this.disposed) 
{ 
CloseSharedMemory(); 
} 
disposed = true; 
} 
private void CloseSharedMemory() 
{ 
if(MemMappedFile != null) 
MemMappedFile.Dispose(); 
} 
public void Close() 
{ 
CloseSharedMemory(); 
} 
#endregion 


#region Properties 

/// <summary> 

/// 内 存 映射 文件 拥有 的 大 小 

/// </summary> 

public int SharedMemoryBaseSize { get; protected set; } 


/// «summary» 

/// 实际 的 内 存 区 大 小 ， 

/// 以 包含 传输 的 对 象 的 大 小 

/// </summary> 

private long MemoryRegionSize => (long)(SharedMemoryBaseSize + sizeof(Int32)); 





/// «summary» 

/// 共享 内 存 区 的 名 称 

/// </summary> 

private string Name { get; } 





/// <summary> 

/// 保护 共享 内 存 的 互 斥 量 的 名 称 

/// </summary> 

private string MutexName => $"{typeof(TransferItemType) }mtx{Name}"; 


/// <summary> 

/// 保护 共享 内 存 的 互 斥 量 

/// </summary> 

private Mutex MutexForSharedMem { get; } = null; 





/// <summary> 

/// 用 于 传输 对 象 的 MemoryMappedFile 

/// </summary> 

private MemoryMappedFile MemMappedFile { get; } = null; 

















#endregion 


#region Public Methods 

/// <summary> 

/// 通过 共享 内 存 发 送 一 个 可 序列 化 对 象 

/// 并 等 待 对 象 被 接收 

/// </summary> 

/// «param name="transfer0bject"> 要 发 送 的 对 象 </param> 




















public void SendObject(TransferItemType transferObject) 


// 创建 内 存 流 ,初始 大 小 


using (MemoryStream ms = new MemoryStream()) 


{ 
// 获得 一 个 用 于 序列 化 的 格式 化 器 


BinaryFormatter formatter = new BinaryFormatter(); 


try 
{ 
// 将 对 象 序列 化 到 流 中 


formatter.Serialize(ms, transferObject); 


// 获得 序列 化 对 象 的 字 市 
byte[] bytes = ms.ToArray(); 


// 检查 该 对 象 大 小 


if(bytes.Length + sizeof(Int32) > MemoryRegionSize) 





























{ 
string msg = 
$"(typeof(TransferItemType)) object instance serialized" + 
$"to {bytes.Length} bytes which is too large for the " + 
$"shared memory region"; 
throw new ArgumentException(msg, nameof(transferObject)); 
} 
// 写 入 到 共享 内 存 区 
using (MemoryMappedViewStream stream = 
MemMappedFile.CreateViewStream()) 
{ 
BinaryWriter writer = new BinaryWriter(stream) ; 
writer .Write(bytes.Length); // 写 入 大 小 
writer.Write(bytes); // 写 入 对 象 
} 
} 
finally 
{ 
// 通知 其 他 使 用 互 斥 量 的 进程 
// 要 进行 接收 处 理 
MutexForSharedMem.ReleaseMutex(); 
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// wait for the other process to signal it has received 
// and we can move on 
MutexForSharedMem.WaitOne(); 


j 


/// <summary> 

/// 等 到 一 个 对 象 进 入 共享 内 存 , 然 后 反 序列 化 它 
/// </summary> 

/// <returns> 传 和 人 的 对 象 </returns> 

public TransferItemType ReceiveObject() 






















































































{ 
// 等 待 互 斥 量 ,直到 发 送 方 将 一 个 对 象 放 入 队列 
MutexForSharedMem.WaitOne(); 
// 从 共享 内 存 中 获得 对 象 
byte[] serializedObj = null; 
using (MemoryMappedViewStream stream = 
MemMappedFile.CreateViewStream()) 
{ 
BinaryReader reader = new BinaryReader (stream); 
int objectLength = reader .ReadInt32(); 
serializedObj = reader .ReadBytes(objectLength) ; 
} 
// 使 用 对 象 字 节 数 据 创 建 内 存 流 
using (MemoryStream ms = new MemoryStream(serializedObj)) 
{ 
// 建立 一 个 二 进 制 格 式 化 器 
BinaryFormatter formatter = new BinaryFormatter(); 
// 获得 对 象 以 返回 
TransferItemType item; 
try 
{ 
item = (TransferItemType) formatter .Deserialize(ms); 
} 
finally 
// 使 用 互 斥 量 通知 我 们 已 接收 到 对 象 
MutexForSharedMem.ReleaseMutex(); 
} 
// 返回 接收 的 对 象 
return item; 
} 
} 
#endregion 


12.7.4 ”参考 


MSDN 文档 中 的 “Memory-Mapped Files” “MemoryMappedFile J£" “Mutex” fi] “Mutex 2E" 





12.8 使 用 事件 协调 线程 


12.8.1 问题 
你 有 多 个 需要 由 一 台 服 务 器 来 服务 的 线程 ， 然 而 一 次 只 能 服务 一 个 线程 。 


12.8.2 ”解决 方案 


当 一 个 线程 将 要 被 服务 时 ， 使 用 AutoResetEvent 通知 每 一 个 线程 。 例 如 ， 一 个 用 餐 者 拥有 
一 个 厨师 和 多 个 服务 员 。 服 务 员 可 以 按 顺 序 提供 服务 ， 但 厨师 每 次 只 能 服务 一 个 人 。 你 可 
以 使 用 例 12-11 中 给 出 的 Cook 类 来 对 此 进行 模拟 。 


例 12-11: 使 用 事件 来 使 线程 协作 
public class Cook 


{ 














public string Name { get; set; } 


public static AutoResetEvent OrderReady = 
new AutoResetEvent(false) ; 


public void CallWaitress() 

{ 
// 我 们 调用 AutoResetEvent 上 的 Set， 
// 但 不 需要 像 ManuaLResetEvent 一 样 
// 调用 Reset 以 再 次 触发 它 
// 这 设置 了 服务 员 在 GetInLine 中 等 待 的 事件 
// BEER Te 
Console.WriteLine($"{Name} finished order!"); 
OrderReady.Set(); 





























} 


Cook 类 有 一 个 名 为 0rderReady 的 AutoResetEvent， 厨 师 用 它 来 告知 等 待 中 的 服务 员 ， 点 餐 
已 经 准备 好 了 。 因 为 一 次 只 能 准备 一 份 点 餐 ， 而 且 对 于 每 位 用 餐 者 来 说 机 会 都 是 均等 的 ， 
所 以 服务 员 将 会 首先 为 等 待 最 和 久 的 客人 送 上 点 餐 。 当 你 调用 orderReady 事件 上 的 Set 时 ， 
AutoResetEvent 只 允许 通知 单个 线程 。 

Waitress 类 拥有 由 线程 执行 的 PlaceOrder 方法 。PLace0rder 接收 两 个 参数 ， 分 别 是 服务 员 
的 姓名 和 AutoResetEvent， 然 后 调用 AutoResetEvent 上 的 WaitOne 等 待 ， 直 到 点 餐 就 绪 为 
止 。 一 旦 Cook 激发 这 个 事件 足够 多 次 ， 使 得 服务 员 位 于 队列 头 ， 那 么 代码 结束 。 


public class Waitress 


{ 



































public static void PlaceOrder(string waitressName, AutoResetEvent orderReady) 
{ 

1/ 下 了 点 餐 订 单 …… 

Console.WriteLine($"Waitress {waitressName} placed order!"); 

// 8e 

orderReady.WaitOne(); 

// 点 餐 已 做 完 …… 
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运行 “用 餐 者 ”的 代码 创建 一 个 Cook， 并 启动 各 个 waitress 线程 ， 
通过 调用 AutoResetEvent 上 的 Set 呼叫 所 有 的 服务 员 。 


次 只 能 准备 一 份 餐 


12.8.3 


Console.WriteLine($"Waitress {waitressName} got order!"); 


} 


























// 我 们 正在 用 餐 ,只 有 一 个 厨师 ， 
Cook Mel = new Cook() { Name = "Mel" }; 








rt 


string[] waitressNames = { "Flo", "Alice", "Vera", "Jolene", 


// 让 服务 员 点 好 餐 


foreach (var waitressName in waitressNames) 


{ 
Task.Run(() => 


// 服务 员 点 好 餐 ,然后 等 餐 


然后 在 准备 好 饭 荣 后 
"Belle" ); 


Waitress.PlaceOrder(waitressName, Cook.OrderReady) ; 

















35 
} 
// 让 厨师 将 点 餐 准 备 好 
for (int i = 0; i < waitressNames.Length; i++) 
{ 
// 让 服务 员 等 一 下 …… 
Thread.Sleep(2000); 
// ok, 下 一 个 服务 员 , 送 餐 
Mel.CallWaitress(); 
} 


讨论 








有 两 种 事件 类 型 存在 ;AutoResetEvent 和 ManuaLResetEvent。 两 类 事件 之 间 主 要 存在 


两 个 方 




















ManualResetEvent 在 Set 被 调用 时 释放 所 有 线程 。 
调用 Set 时 ， 它 自动 重 置 到 一 种 无 信号 的 状态 ， 而 ManualResetEvent 会 处 于 有 信号 的 状 
态 ， 直 至 调用 Reset 方法 为 止 。 


示例 代码 的 输出 如 下 所 示 。 











Waitress Alice placed order! 
Waitress Flo placed order! 
Waitress Vera placed order! 
Waitress Jolene placed order! 
Mel finished order! 

Waitress Alice got order! 
Waitress Belle placed order! 
Mel finished order! 

Waitress Jolene got order! 
Mel finished order! 

Waitress Belle got order! 
Mel finished order! 

Waitress Flo got order! 





下 的 不 同 。 第 一 是 AutoResetEvent 只 释放 等 待 事件 的 众多 线程 中 的 一 个 ， 而 


第 二 点 不 同 在 于 当 在 AutoResetEvent 上 








Mel finished order! 
Waitress Vera got order! 


12.84 参考 


MSDN 文档 中 的 “AutoResetEvent” 和 “ManuaLResetEvent” 主 题 ， 以 及 《Windows 核心 
编程 》。 


12.9 在 多 线程 间 执 行 原子 操作 


12.9.1 问题 
你 正在 操作 来 自 多 个 线程 的 数据 ， 和 希望 确保 每 次 操作 在 执行 来 自 另 一 线程 的 下 一 次 操作 之 


前 完全 执行 。 


12.9.2 解决 方案 


使 用 Interlocked 系列 函数 来 确保 原子 访问 。Interlocked 拥有 一 些 方法 ， 用 于 增加 和 减少 
值 ， 让 一 个 给 定 的 值 增加 一 定数 量 ， 用 一 个 新 值 替 换 一 个 初始 值 ， 比 较 当 前 值 与 初始 值 ， 
以 及 当初 始 值 等 于 当前 值 时 将 初始 值 替 换 为 一 个 新 值 。 
要 增加 和 减少 一 个 整数 值 ， 可 分 别 使 用 Increment 或 Decrement 方法 。 
int i = 0; 
long l = 0; 
Interlocked.Increment(ref i); // i 
Interlocked.Decrement(ref i); // i 


Interlocked.Increment(ref 1); // l 
Interlocked.Decrement(ref i); // l 


要 让 一 个 给 定 的 整数 值 增加 特定 数量 ， 可 使 用 Add 方法 。 


Interlocked.Add(ref i, 10); // i = 10; 
Interlocked.Add(ref 1, 100); // l = 100; 


要 替换 一 个 已 有 的 值 ， 可 使 用 Exchange 方法 。 


string name = "Mr. Ed"; 
Interlocked.Exchange(ref name, "Barney"); 


要 在 替换 现 有 值 之 前 检查 是 否 另 一 个 线程 已 经 修改 了 来 自 现 有 代码 的 值 ， 可 使 用 
CompareExchange 方法 。 
































uon ow a i 
OPOPp 


























int i = 0; 
double runningTotal = 0.0; 
double startingTotal = 0.0; 
double calc = 0.0; 
for (i = 0; i < 10; i++) 
{ 

do 
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// 保存 初始 值 

startingTotal = runningTotal; 

// 执行 一 个 密集 计算 

calc = runningTotal + i * Math.PI * 2 / Math.PI; 
} 
// 检查 已 确保 runningTotal 未 被 修改 
// 如 果 未 修改 , 则 使 用 calc 赫 换 
// 如 果 已 修改 , 则 执行 循环 ,直到 我 们 获得 了 当前 值 为 止 
while (startingTotal != 

Inter Locked. CompareExchange( 

ref runningTotal, calc, startingTotal)); 









































j 


12.9.3 讨论 


对 于 诸如 Microsoft Windows 这 种 能 够 执行 抢占 式 多 任务 的 操作 系统 ， 工 作 于 多 线程 时 必 
须要 考虑 数据 完整 性 。 有 许多 同步 原 语 可 帮助 保护 代码 段 ， 以 及 在 有 可 供 修改 的 数据 时 发 
出 信号 。 此 列表 还 增加 了 一 项 能 力 ， 用 于 执行 本 质 上 是 原子 操作 的 那些 操作 。 


如 果 你 过 去 对 于 线程 和 汇编 语言 接触 得 不 多 ， 那 么 或 许 会 想 知道 : 这 有 什么 大 不 了 的 ， 到 
底 为 什么 需要 这 些 原子 函数 ?最 基本 的 原因 是 ， 用 C# 编写 的 代码 最 终 必须 要 被 翻译 为 机 
器 指令 ， 而 在 这 个 过 程 中 ， 用 CH 编写 的 一 行 代码 能 转换 成 多 条 指令 由 机 器 来 执行 。 如 果 
机 器 必须 要 执行 多 条 指令 来 完成 一 个 任务 ， 而 操作 系统 允许 抢占 ， 那 么 这 些 指令 就 可 能 没 
有 作为 一 个 单元 被 执行 。 在 CH 代码 执行 的 过 程 中 ， 它 们 会 被 其 他 代码 中 断 ， 改 变 正 被 原 
Fe C# 代码 修改 的 值 。 可 以 想象 ， 这 可 能 会 导致 很 严重 的 错误 ， 或 者 就 像 对 彩票 号 码 进行 
De ABE, ULES CE 编程 人 员 始 终 无 法 赢得 大 奖 。 

线程 是 一 个 强大 的 工具 ， 但 是 与 其 他 大 多 数 “ 强 大 ”的 工具 一 样 ， 你 必须 了 解 它 的 操作 才 
能 高 效 、 安 全 地 使 用 它 。 线 程 bug 给 调试 带 来 很 大 的 难题 ， 因 为 运行 时 的 行为 并 不 是 固定 
的 。 试 图 重 现 它们 如 同 恶 梦 一 般 ， 添 加 日 志 会 修改 其 行为 ， 或 者 更 精 一 一 导致 问题 消失 。 
要 承认 ,在 多 线程 环境 中 工作 必须 对 保护 数据 访问 进行 一 定 的 预先 考虑 ， 理 解 何 时 使 用 
Inter locked 类 有 助 于 避免 长 与 调试 器 相伴 的 令 人 诅 丧 的 漫 宴 长 夜 。 



















































































12.9.4 84 


MSDN 文档 中 的 “Interlocked” 和 “Interlocked 类 ”主题 。 
12.40 ”优化 以 读 为 主 的 访问 


12.10.1 问题 


你 在 操作 多 数 情况 下 读 取 只 是 偶尔 会 更 新 的 数据 ， 希 望 以 线程 安全 但 高 效 的 方式 执行 这 些 
操作 。 
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12.10.22 ”解决 方案 





使 用 ReaderwriterLockSLim， 赋 予 多 重读 /单一 写 访问 以 及 将 锁 从 读 升级 为 写 的 能 力 。 举 


例 来 说 ， 一 个 开发 者 开始 做 一 个 新 项 目 。 不 幸 的 是 ， 这 个 项 目 人 员 不 足 ， 所 以 ， 这 个 姑 








zi 





者 必须 响应 来 自 团 队 中 其 他 许多 人 员 的 任务 。 每 个 其 他 的 团队 成 员 也 要 求 开 发 者 更 新 他 们 








任务 上 的 状态 ， 一 些 人 甚至 要 改变 开发 者 分 配 的 任务 的 优先 级 。 





通过 AddTask 方法 向 开发 者 分 配 一 个 任务 。 为 了 保护 DeveloperTasks 集合 ， 我 们 使 用 
一 个 ReaderWriterLockSlim 上 的 写 锁 ， 在 将 任务 添加 到 DeveloperTasks 集合 时 调用 


EnterwWriteLock， 添 加 完成 之 后 调用 ExttWriteLock, 


public void AddTask(DeveloperTask newTask) 








{ 
try 
{ 
Lock. EnterWriteLock(); 
// 如 果 我 们 已 经 有 了 此 任务 (名 称 唯一 ) 
// 那么 就 仅仅 接受 任务 添加 
// 因为 有 时 人 们 不 止 一 次 给 你 同一 个 任务 
var taskQuery = from t in DeveloperTasks 
where t == newTask 
select t; 
if (taskQuery.Count<DeveloperTask>() == 0) 
{ 
Console.WriteLine($"Task (newTask.Name) was added to developer"); 
DeveloperTasks.Add(newTask); 
} 
} 
finally 
Lock. ExitWriteLock(); 
} 
} 





EnterReadLock 和 ExitReadLock 在 ReaderWriterLockSlim 上 使 用 一 个 读 锁 。 





public bool IsTaskDone(string taskName) 
{ 
try 
{ 
Lock. EnterReadLock(); 
var taskQuery = from t in DeveloperTasks 


where t.Name == taskName 
select t; 
if (taskQuery.Count<DeveloperTask>() > 0) 
{ 
DeveloperTask task = taskQuery.First<DeveloperTask>(); 
Console.WriteLine($"Task {task.Name} status was reported."); 
return task.Status; 
} 
} 
finally 


当 项 目 团队 成 员 需 要 了 解 任务 状态 时 ， 他 们 调用 IsTaskDone 方法 。 该 方法 通过 调用 
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{ 
} 


return false; 


Lock. ExitReadLock(); 


} 


开发 团队 的 某 些 管 理 成 员 有 权力 提高 他 们 赋予 开发 者 的 任务 优先 级 。 这 可 以 通过 调用 开发 
者 的 IncreasePriority 方法 来 完成 。IncreasePriority 使 用 ReaderWriterLockSlim 上 的 一 
个 可 升级 锁 ， 首 先 通过 调用 EnterUpgradeableReadLock 方法 获取 一 个 读 锁 ， 然 后 如 果 任 务 
在 队列 中 ， 升 级 为 一 个 写 锁 以 调整 任务 的 优先 级 。 一 旦 优先 级 调整 了 ， 写 锁 被 释放 ， 它 就 
会 将 锁 降 级 到 读 锁 ， 并 通过 调用 ExitUpgradeableReadLock 来 释放 锁 。 


public void IncreasePriority(string taskName) 












































t 
try 
{ 
Lock. EnterUpgradeableReadLock( ); 
var taskQuery = from t in DeveloperTasks 
where t.Name == taskName 
select t; 
if (taskQuery.Count<DeveloperTask>()>0) 
{ 
DeveloperTask task = taskQuery.First<DeveloperTask>(); 
Lock. EnterWriteLock(); 
task.Priority++; 
Console.WriteLine($"Task {task.Name}" + 
$" priority was increased to {task.Priority}" + 
" for developer"); 
Lock.ExitWriteLock(); 
} 
} 
finally 
{ 
Lock. ExitUpgradeableReadLock(); 
} 
} 


12.10.3 讨论 

出 于 以 下 三 个 原因 ， 会 创建 ReaderWriterLockSlim 以 灰 代 现 有 的 ReaderWriterLock, 
。 使 用 ReaderWriterLock 比 使 用 Monitor 慢 5 ff, 

e ReaderWriterLock 的 递归 语义 不 标准 ， 而 且 在 某 些 线程 重 入 的 情况 下 会 中 断 。 

。 ReaderWriterLock 的 升级 锁 方 法 不 是 原子 的 。 
ReaderWriterLockSlim 只 比 Monitor 慢 两 倍 ， 而 且 更 加 灵活 、 优 先 写 ， 因 此 在 写 少 读 多 的 
情况 下 ， 它 比 Monitor 更 具 扩展 性 。 同 时 还 有 方法 可 以 确定 持 有 何 种 锁 并 确定 有 多 少 线程 
正在 等 待 获取 它 。 

在 默认 情况 下 ， 不 允许 锁 的 递归 获取 。 如 果 你 调用 EnterReadLock 两 次 ， 将 会 得 到 一 个 
LockRecursionException。 锁 递归 可 以 通过 将 LockRecusionPolicy.SupportsRecursion 枚 举 




















值 传人 重 载 的 ReaderWriterLockslim £435 PBK Ja. BIE BESSER BA, — fie te HE 

荐 ， 因 为 它 会 让 事情 变 得 复杂 ， 而 且 产生 难以 调试 的 问题 。 

存在 以 下 这 些 不 适合 使 用 ReaderWriterLockSlim 的 情况 ， 尽 管 
况 并 不 是 日 常 开 发 中 会 遇 到 的 。 

。 因为 不 兼容 的 HostProtection 特性 ， 所 以 ReaderWriterLockSlim 不 应 在 

SQL Server CIR 场景 中 使 用 。 

。 因 为 ReaderWriterLockSlim 没有 标记 关键 区 域 ， 使 用 线程 中 断 的 宿主 不 
知道 自己 将 会 受到 线程 中 断 的 何 种 损害 ， 所 以 租 入 的 AppDomain 中 会 发 生 
错误 。 

* ReaderWriterLockSlin 不 能 处 理 异步 异常 (线程 中 断 、 内 存 溢出 等 )， 可 能 
会 在 损坏 的 锁 状 态 中 结束 。 这 可 能 导致 死 锁 或 者 其 他 问题 。 

。 因为 ReaderWriterLockSlim 具有 线程 关联 性 ， 所 以 它 通 常 不 能 用 于 async 

和 await。 对 于 这 些 情况 ， 使 用 SemaphoreSlim.WaitAsync 来 代 赫 。 


























中 大 多 数 情 













































































针对 这 一 示例 的 全 部 代码 如 下 所 示 。 


static Developer s_dev = null; 
static bool s_end = false; 


/// <summary> 


/// </summary> 
public static void TestReaderWriterLockSlim() 


{ 
s_dev = new Developer(15); 
LaunchTeam(s_dev); 
Thread.Sleep(10000) ; 

} 

private static void LaunchTeam(Developer dev) 

{ 
LaunchManager("CTO", dev); 
LaunchManager("Director", dev); 
LaunchManager("Project Manager", dev); 
LaunchDependent("Product Manager", dev); 
LaunchDependent("Test Engineer", dev); 
LaunchDependent("Technical Communications Professional", dev); 
LaunchDependent("Operations Staff", dev); 
LaunchDependent("Support Staff", dev); 

} 

public class DeveloperTaskInfo 

{ 
public string Name { get; set; } 
public Developer Developer { get; set; } 

} 


private static void LaunchManager(string name, Developer dev) 


( 
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} 


var dti = new DeveloperTaskInfo() { Name = name, Developer = dev }; 
Task manager = Task.Run(() => { 
Console.WriteLine($"Added {dti.Name} to the project..."); 
DeveloperTaskManager mgr = new DeveloperTaskManager(dti.Name, 
dti.Developer); 


J); 


private static void LaunchDependent(string name, Developer dev) 


{ 


} 


var dti = new DeveloperTaskInfo() { Name = name, Developer = dev }; 
Task manager = Task.Run(() => { 
Console.WriteLine($"Added {dti.Name} to the project..."); 
DeveloperTaskDependent dep = 
new DeveloperTaskDependent(dti.Name, dti.Developer); 


F); 


public class DeveloperTask 


{ 


} 


public DeveloperTask(string name) 


{ 
} 


Name = name; 


public string Name { get; set; } 
public int Priority { get; set; } 
public bool Status { get; set; } 


public override string ToString() => this.Name; 


public override bool Equals(object obj) 
{ 


DeveloperTask task = obj as DeveloperTask; 
return this.Name == task?.Name; 


} 


public override int GetHashCode() => this.Name.GetHashCode(); 


public class Developer : IDisposable 


{ 


{|| «summary» 
/// 任务 字典 
/// </summary> 
private List<DeveloperTask> DeveloperTasks { get; } = 
new List<DeveloperTask>(); 
private ReaderWriterLockSlim Lock { get; set; } = new ReaderWriterLockSlim(); 
private System.Threading.Timer Timer { get; set; } 
private int MaxTasks { get; } 





public Developer(int maxTasks) 
{ 
// 开发 者 能 接受 而 不 至 于 离开 的 最 大 任务 数 


MaxTasks = maxTasks; 











// 每 1/4 秒 进行 某 项 工作 
Timer = new Timer(new TimerCallback(DoWork), null, 1000, 250); 


} 
^Developer() 
{ 
Dispose(true); 
} 


// 执行 一 个 任务 


protected void DoWork(Object stateInfo) 








{ 
ExecuteTask(); 
try 
{ 
Lock. EnterWriteLock(); 
// 如 果 完 成 了 所 有 任务 ,就 去 度 个 假 
if (DeveloperTasks.Count == 0) 
{ 
s_end = true; 
Console.WriteLine( 
"Developer finished all tasks, go on vacation!"); 
return; 
} 
if (!s_end) 
{ 
// 如 果 有 太 多 的 任务 ,就 退出 
if (DeveloperTasks.Count > MaxTasks) 
{ 
// 获得 未 完成 的 任务 数量 
var query = from t in DeveloperTasks 
where t.Status == false 
select t; 
int unfinishedTaskCount = query.Count<DeveloperTask>(); 
s_end = true; 
Console.WriteLine( 
"Developer has too many tasks, quitting! " + 
$"{unfinishedTaskCount} tasks left unfinished."); 
} 
} 
else 
Timer .Dispose(); 
} 
finally 
{ 
Lock. ExitWriteLock(); 
} 
} 
public void AddTask(DeveloperTask newTask) 
{ 
try 
{ 
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Lock. EnterWriteLock(); 

// 如 果 我 们 已 经 有 了 此 任务 (名 称 唯一 ) 
// 那么 就 仅仅 接受 任务 添加 

// 因为 有 时 人 们 不 止 一 次 给 你 同一 个 任务 


var taskQuery = from t in DeveloperTasks 
































where t == newTask 
select t; 
if (taskQuery.Count<DeveloperTask>() == 0) 
{ 
Console.WriteLine($"Task {newTask.Name} was added to developer"); 
DeveloperTasks.Add(newTask); 
} 
} 
finally 
{ 
Lock. ExitWriteLock(); 
} 


} 


/// «summary» 

/// 提高 任务 的 优先 级 

/// </summary> 

/// «param name="taskName"> 任 务 的 名 称 </param> 
public void IncreasePriority(string taskName) 





{ 
try 
{ 
Lock. EnterUpgradeableReadLock() ; 
var taskQuery = from t in DeveloperTasks 
where t.Name == taskName 
select t; 
if (taskQuery.Count<DeveloperTask>()>0) 
{ 
DeveloperTask task = taskQuery.First<DeveloperTask>(); 
Lock. EnterWriteLock(); 
task.Priority++; 
Console.WriteLine($"Task {task.Name}" + 
$" priority was increased to {task.Priority}" + 
" for developer"); 
Lock. ExitWriteLock(); 
} 
} 
finally 
{ 
Lock. ExitUpgradeableReadLock(); 
} 
} 


// <summary> 

// 允许 人 们 检查 任务 是 否 已 完成 

// </summary> 

// «param name="taskName"> 任 务 的 名 称 </param> 
// <returns> 如 果 任 务 未 完成 或 不 在 列表 中 , 则 返 
// 如 果 已 完成 , 则 返回 true</returns> 

public bool IsTaskDone(string taskName) 








false 





Ln 





























try 
{ 
Lock. EnterReadLock( ); 
var taskQuery = from t in DeveloperTasks 
where t.Name == taskName 
select t; 
if (taskQuery.Count<DeveloperTask>() > 0) 
{ 
DeveloperTask task = taskQuery.First<DeveloperTask>(); 
Console.WriteLine($"Task {task.Name} status was reported."); 
return task.Status; 
} 
} 
finally 
{ 
Lock.ExitReadLock(); 
} 
return false; 
} 
private void ExecuteTask() 
{ 
// 查看 任务 列表 并 执行 最 高 优先 级 的 任务 
var queryResult = from t in DeveloperTasks 
where t.Status == false 
orderby t.Priority 
select t; 
if (queryResuLt.Count<DeveloperTask>() > 0) 
{ 
// 执行 任务 
DeveloperTask task = queryResult.First<DeveloperTask>(); 
task.Status = true; 
task.Priority = -1; 
Console.WriteLine($"Task {task.Name} executed by developer."); 
} 
} 


#region IDisposable Support 
private bool disposedValue = false; // 用 于 检测 宛 余 的 调用 























protected virtual void Dispose(bool disposing) 


{ 
if (!disposedValue) 
{ 
if (disposing) 
{ 
Lock? .Dispose(); 
Lock = null; 
Timer?.Dispose(); 
Timer = null; 
} 
disposedValue = true; 
} 
} 





线程 、 同 步 和 并 发 | 535 





public void Dispose() 


{ 

Dispose(true); 
} 
#endregion 


} 


public class DeveloperTaskManager : DeveloperTaskDependent, IDisposable 


{ 


private System.Threading.Timer ManagerTimer { get; set; } 


public DeveloperTaskManager(string name, Developer taskExecutor) : 
base(name, taskExecutor ) 


// 每 2 秒 进行 干预 
ManagerTimer = 
new Timer(new TimerCallback(Intervene), null, 0, 2000); 








} 
~DeveloperTaskManager() 
{ 
Dispose(true); 
} 
// 干预 任务 
protected void Intervene(Object stateInfo) 
{ 
ChangePriority(); 
// 开发 完成 ,释放 计时 器 
if (s_end) 
{ 
ManagerTimer .Dispose(); 
TaskExecutor = null; 
} 
} 


public void ChangePriority() 
{ 
if (DeveloperTasks.Count > 0) 
{ 
int taskIndex = _rnd.Next(0, DeveloperTasks.Count - 1); 
DeveloperTask checkTask = DeveloperTasks[taskIndex]; 
// 确认 开发 者 在 某 些 随 机 的 任务 上 干 快 一 些 
if (TaskExecutor != null) 


{ 














TaskExecutor .IncreasePriority(checkTask.Name); 
Console.WriteLine( 
s"{Name} intervened and changed priority for task 
{checkTask.Name}"); 


j 
} 


#region IDisposable Support 





} 

















private bool disposedValue = false; // 用 于 检测 元 余 的 调 月 


protected override void Dispose(bool disposing) 


{ 
if (!disposedValue) 


{ 
if (disposing) 
ManagerTimer?.Dispose(); 
ManagerTimer = null; 
base.Dispose(disposing); 
} 
disposedValue = true; 
} 
} 
public new void Dispose() 
{ 
Dispose(true); 
} 
#endregion 


public class DeveloperTaskDependent : IDisposable 


{ 





protected List<DeveloperTask> DeveloperTasks { get; set; } 


= new List<DeveloperTask>(); 
protected Developer TaskExecutor { get; set; } 


protected Random _rnd = new Random(); 
private Timer TaskTimer { get; set; } 
private Timer StatusTimer { get; set; } 


public DeveloperTaskDependent(string name, Developer taskExecutor ) 





t 
Name - name; 
TaskExecutor = taskExecutor; 
// 每 秒 钟 添 加 工作 
TaskTimer = new Timer(new TimerCallback(AddWork), null, 0, 1000); 
// 每 3 秒 检查 状态 
StatusTimer = new Timer(new TimerCallback(CheckStatus), null, 0, 3000); 
} 
~Deve LoperTaskDependent( ) 
{ 
Dispose(); 
} 


// 添加 更 多 的 工作 给 开发 者 
protected void AddWork(Object stateInfo) 
{ 








SubmitTask(); 

// 开发 完成 ,释放 计时 器 
if (s_end) 

{ 
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TaskTimer.Dispose(); 
TaskExecutor - null; 


} 


// 检查 开发 者 的 工作 状态 
protected void CheckStatus(Object stateInfo) 














{ 
CheckTaskStatus(); 
// 开发 完成 ,释放 计时 器 
if (s_end) 
{ 
StatusTimer .Dispose(); 
TaskExecutor = null; 
} 
} 


public string Name { get; set; } 


public void SubmitTask() 





{ 
int taskId = _rnd.Next(10000) ; 
string taskName = $"({taskId} for {Name})"; 
DeveloperTask newTask = new DeveloperTask(taskName) ; 
if (TaskExecutor != null) 
{ 
TaskExecutor .AddTask(newTask) ; 
DeveloperTasks.Add(newTask); 
} 
} 
public void CheckTaskStatus() 
{ 
if (DeveloperTasks.Count > 0) 
{ 
int taskIndex = _rnd.Next(0, DeveloperTasks.Count - 1); 
DeveloperTask checkTask = DeveloperTasks[taskIndex]; 
if (TaskExecutor != null && 
TaskExecutor .IsTaskDone(checkTask.Name) ) 
{ 
Console.WriteLine($"Task {checkTask.Name} is done for {Name}"); 
// 从 待 办 列表 中 移 除 它 
DeveloperTasks.Remove(checkTask); 
} 
} 
} 


#region IDisposable Support 
private bool disposedValue = false; // 用 于 检测 宛 余 的 调用 














protected virtual void Dispose(bool disposing) 


{ 
if (!disposedValue) 





} 


if (disposing) 


{ 


} 


TaskTimer? .Dispose(); 
TaskTimer = null; 
StatusTimer?.Dispose(); 
StatusTimer = null; 


disposedValue = true; 


public void Dispose() 


{ 
} 


Dispose(true); 


#endregion 


} 


lin 





你 可 以 在 输出 中 看 到 项 目的 事件 序列 。 





Added 
Added 
Added 
Added 
Added 
Added 
Added 
Added 
Task 
Task 
Task 
CTO i 
Task 
Task 
Task 


CTO to the project... 


Director 


to the project... 


Project Manager to the project... 

Product Manager to the project... 

Test Engineer to the project... 

Technical Communications Professional to the project... 
Operations Staff to the project... 

Support Staff to the project... 


(6267 for 
(6267 for 
(6267 for 
ntervened 
(6267 for 
(6267 for 
(6267 for 


CTO) was added to developer 

CTO) status was reported. 

CTO) priority was increased to 1 for developer 

and changed priority for task (6267 for CTO) 
Director) was added to developer 

Director) status was reported. 

Director) priority was increased to 1 for developer 


Director intervened and changed priority for task (6267 for Director) 

Task (6267 for Project Manager) was added to developer 

Task (6267 for Project Manager) status was reported. 

Task (6267 for Project Manager) priority was increased to 1 for developer 
Project Manager intervened and changed priority for task (6267 for Project 
Manager) 


Task 
Task 
Task 
Task 
Task 
Task 
Task 
Task 
Task 
Task 
Task 
Task 
Task 
Task 


(6267 for 
(6267 for 
(6267 for 
(6267 for 
(6267 for 
(6267 for 
(6267 for 
(6267 for 
(6267 for 
(5368 for 
(5368 for 
(5368 for 
(6153 for 


Product Manager) was added to developer 

Product Manager) status was reported. 

Technical Communications Professional) was added to developer 
Technical Communications Professional) status was reported. 
Operations Staff) was added to developer 

Operations Staff) status was reported. 

Support Staff) was added to developer 

Support Staff) status was reported. 

Test Engineer) was added to developer 

CTO) was added to developer 

Director) was added to developer 

Project Manager) was added to developer 

Product Manager) was added to developer 


(913 for Test Engineer) was added to developer 
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Task 
Task 
Task 
Task 
Task 
Task 
Task 
Task 


(6153 
(6153 
(6153 
(6267 
(6267 
(6267 
(6267 
(6267 


for 
for 
for 
for 
for 
for 
for 
for 


CTO intervened 
Task (6267 for 
Director intervened and changed priority for task (6267 for Director) 

Task (6267 for Project Manager) priority was increased to 2 for developer 
Project Manager intervened and changed priority for task (6267 for Project 
Manager) 


Task 
Task 
Task 
Task 
Task 
Task 
Task 
Task 
Task 
Task 
Task 
Task 
Task 
Task 
Task 
Task 
Task 
Task 


(6267 
(7167 
(7167 
(7167 
(5368 
(6153 
(5368 
(5368 
(5368 
(5368 
(5368 
(5368 
(6267 
(6267 
(6267 


for 
for 
for 
for 
for 
for 
for 
for 
for 
for 
for 
for 
for 
for 
for 


Technical Communications Professional) was added to developer 
Operations Staff) was added to developer 

Support Staff) was added to developer 

Product Manager) executed by developer. 

Technical Communications Professional) executed by developer. 
Operations Staff) executed by developer. 

Support Staff) executed by developer. 

CTO) priority was increased to 2 for developer 

and changed priority for task (6267 for CTO) 

Director) priority was increased to 2 for developer 


Test Engineer) executed by developer. 
CTO) was added to developer 

Director) was added to developer 

Project Manager) was added to developer 
Product Manager) was added to developer 
Test Engineer) was added to developer 
Technical Communications Professional) was added to developer 
Operations Staff) was added to developer 
Support Staff) was added to developer 
CTO) executed by developer. 

Director) executed by developer. 

Project Manager) executed by developer. 
CTO) status was reported. 

Director) status was reported. 

Project Manager) status was reported. 


(913 for Test Engineer) status was reported. 


(6267 
(6267 


for 
for 


Communications 


Task 
Task 
Task 
Task 
Task 
Task 
Task 
Task 
Task 
Task 
Task 
Task 
Task 
Task 
Task 
Task 
Task 


(6267 
(6267 
(6267 
(6267 
(6267 
(6267 
(6153 
(2987 
(2987 
(2987 
(7167 
(4126 
(7167 
(7167 
(7167 


for 
for 
for 
for 
for 
for 
for 
for 
for 
for 
for 
for 
for 
for 
for 


Technical Communications Professional) status was reported. 
Technical Communications Professional) is done for Technical 
Professional 

Product Manager) status was reported. 

Product Manager) is done for Product Manager 

Operations Staff) status was reported. 

Operations Staff) is done for Operations Staff 

Support Staff) status was reported. 

Support Staff) is done for Support Staff 

Product Manager) executed by developer. 

CTO) was added to developer 

Director) was added to developer 

Project Manager) was added to developer 

Product Manager) was added to developer 

Test Engineer) was added to developer 

Technical Communications Professional) was added to developer 
Support Staff) was added to developer 

Operations Staff) was added to developer 


(913 for Test Engineer) executed by developer. 

(6153 for Technical Communications Professional) executed by developer. 
Developer has too many tasks, quitting! 21 tasks left unfinished. 

Task (6153 for Operations Staff) executed by developer. 

Task (5368 for CTO) priority was increased to 0 for developer 

CTO intervened and changed priority for task (5368 for CTO) 

Task (5368 for Director) priority was increased to 0 for developer 





Director intervened and changed priority for task (5368 for Director) 

Task (5368 for Project Manager) priority was increased to 0 for developer 
Project Manager intervened and changed priority for task (5368 for Project 
Manager) 

Task (6153 for Support Staff) executed by developer. 

Task (4906 for Product Manager) was added to developer 

Task (7167 for Test Engineer) was added to developer 

Task (4906 for Technical Communications Professional) was added to developer 
Task (4906 for Operations Staff) was added to developer 

Task (4906 for Support Staff) was added to developer 

Task (7167 for CTO) executed by developer. 

Task (7167 for Director) executed by developer. 

Task (7167 for Project Manager) executed by developer. 

Task (5368 for Product Manager) executed by developer. 

Task (6153 for Test Engineer) executed by developer. 

Task (5368 for Technical Communications Professional) executed by developer. 
Task (5368 for Operations Staff) executed by developer. 

Task (5368 for Support Staff) executed by developer. 

Task (2987 for CTO) executed by developer. 

Task (2987 for Director) executed by developer. 

Task (2987 for Project Manager) executed by developer. 

Task (7167 for Product Manager) executed by developer. 

Task (4126 for Test Engineer) executed by developer. 


12.10.04 B84 


MSDN 文档 中 的 “ReaderNriterLockSLim” 主 题 。 


12.11 使 数据 库 请 求 更 具 扩展 性 


12.11.1 问题 
你 希望 使 你 的 数据 库 调用 从 调用 方 的 角度 来 看 尽 可 能 高 效 和 可 扩展 。 


12.11.2 解决 方案 


使 用 async、await 和 *Async 版 本 的 数据 库 调 用 。 这 样 在 等 待 数 据 库 IO 完成 时 ， 应 用 程 
序 中 的 线程 可 以 完成 其 他 工作 。 

















如 果 你 不 熟悉 在 CH 5.0 中 引入 的 async 和 await， 请 参阅 MSDN 主题 “使 用 
Async 和 Await 的 异步 编程 ”以 了 解 详细 信息 。 
































如 果 你 在 用 SqlConnection 和 SqLCommand， 可 以 使 用 SqlConnection.OpenAsync 和 SqLCommand . 
ExecuteReaderAsync 方法 以 异步 方式 打开 并 查询 数据 库 ， 代 码 如 下 所 示 。 
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using (SqlConnection conn = 


{ 


} 


new SqlConnection(Settings.Default.NorthwindConnectionString)) 


await conn.OpenAsync(); 
SqlCommand cmd = new SqlCommand("SELECT * FROM CUSTOMERS", conn); 
SqlDataReader reader = await cmd.ExecuteReaderAsync(); 
while (reader.Read()) 
{ 
Console.WriteLine($"Customer {reader["ContactName"].ToString()} " + 
$"from {reader["CompanyName"].ToString()}"); 














如 果 你 在 用 Entity Framework， 可 以 使 用 IQueryable<T>.ToListAsync 扩展 方法 以 异步 方式 
打开 连接 并 执行 查询 ， 代 码 如 下 所 示 。 


using (var efContext = new NorthwindEntities()) 


{ 





var list = await (from cust in efContext.Customers 
select cust).ToListAsync(); 


foreach(var cust in list) 


{ 


Console.WriteLine($"Customer {cust.ContactName} " + 
$"from {cust.CompanyName}"); 


} 














如 果 你 想 使 用 EntityFramework 写 一 条 新 的 记录 ， 然 后 获取 它 以 查看 ， 可 以 在 将 新 实体 添 
加 到 上 下 文 之 后 使 用 System.Data.Entity.DbContext.SaveChangesAsync 方法 。 然 后 你 可 以 
使 用 IQueryable<T>.FirstOrDefaultAsync 扩展 方法 获取 第 一 个 匹配 项 或 nuLL， 代 码 如 下 





所 示 。 

















// 创建 新 的 customer 并 且 保 存 

Customer c = new Customer(); 
c.CustomerID = "JENNA"; 

c.ContactName = "Jenna Roberts"; 
c.CompanyName = "Flamingo Industries"; 
efContext.Customers.Add(c); 

await efContext.SaveChangesAsync(); 


var jenna = await efContext.Customers.Where(cu => 
cu.ContactName == "Jenna Roberts").FirstOrDefaultAsync(); 
Console.WriteLine($"New Customer {jenna.ContactName} " + 
$"from {jenna.CompanyName}") ; 


12.11.3 讨论 

尽管 一 些 数据 库 技 术 目 前 已 实现 异步 支持 ， 但 并 不 是 所 有 数据 库 技 术 都 这 么 幸运 。LINQ to 
SQL 仍然 派生 自 System.Data.Linq.DataContext， 它 没有 异步 支持 。 不 过 你 仍 可 以 将 LINQ 
to SQL 用 于 非 异 步 操作 ， 如 下 所 示 。 











using (var l2sContext = new NorthwindLing2SqlDataContext()) 


{ 

var list = (from cust in l2sContext.Customers 

select cust); 
foreach (var cust in list) 
{ 
Console.WriteLine($"Customer {cust.ContactName} " + 
$"from {cust.CompanyName}"); 

} 

} 


如 果 你 尝试 将 如 下 所 示 的 async 支持 与 LINQ to SQL 一 起 使 用 ， 将 收 到 此 错误 。 


var list = await (from cust in l2sContext.Customers 

select cust).ToListAsync(); 

// 额外 信息 : The source IQueryable doesn't implement 

// IDbAsyncEnumerable«NorthwindLinq2Sql.Customer». Only sources that implement 
// IDbAsyncEnumerable can be used for Entity Framework 


如 果 你 想 要 数据 库 操 作 的 异步 支持 ， 需 要 使 用 System.Data.SqlClient 构造 (如 SqlConnection, 
SqlDataReader 等 ) 或 使 用 Entity Framework 6 或 更 高 版 本 。 


12.114 ”参考 


MSDN 文档 中 的 “System.Data.SqLCLient 命名 空间 ?“ 使 用 Async fH Await 的 异步 编程 ” 
和 “Entity Framework Async Query & Save” 主 题 。 


12.12 ”以 一 定 顺 序 运行 任务 


12.12.1 问题 
在 你 的 应 用 程序 中 ， 你 有 需要 在 从 属 任务 执行 之 前 完成 的 初始 任务 。 


12.12.2 解决 方案 

使 用 Task. Continuewith 以 在 初始 任务 完成 之 后 执行 后 续 任务 。 

Continuebiith 允许 你 追加 一 个 任务 在 初始 任务 完成 之 后 异步 执行 。 这 在 一 些 任务 有 顺序 约 
束 而 另 一 些 任务 没有 顺序 约束 的 情况 下 很 有 用 。 

作为 一 个 例子 ， 想 想 奥运 会 4x 400 米 接力 赛 。 其 中 有 一 些 初级 任务 (每 个 国家 的 第 一 棒 
起 跑 者 ) ， 接 下 来 是 依赖 第 一 个 任务 结果 的 任务 ( 跑 接力 剩余 棱 的 选手 )。 在 前 一 个 任务 完 
成 (接力 棒 传递 ) 之 前 ， 这 些 依赖 任务 都 不 能 开始 。 

要 表示 每 个 接力 中 的 选手 ， 我 们 有 一 个 RetayRunner 类 ， 包 含 选手 代表 的 国家 (Country), 
其 所 跑 的 那 一 段 (Leg)， 目 前 是 否 拥有 接力 棒 (HasBaton), ， 以 及 跑 完 接 力 这 一 段 所 花 的 时 
间 (LegTine)。 最 后 ， 有 一 个 方法 ， 使 RetayRunner 在 轮 到 该 选手 时 冲刺 (Sprint) 


public class RelayRunner 
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有 了 选手 之 后 ， 我 们 需要 建立 他 们 代表 的 国家 (countries) 和 一 些 跟踪 变量 ， 关 于 每 
个 团队 中 有 谁 参 加 赛跑 (teams)， 是 谁 在 参加 比赛 runners)， 以 及 谁 是 第 一 棒 起 跑 者 





public string Country { get; set; } 
public int Leg { get; set; } 

public bool HasBaton { get; set; } 
public TimeSpan LegTime { get; set; } 
public int TotalLegs { get; set; } 


public RelayRunner Sprint() 


{ 
Console.WriteLine( 
$"{Country} for Leg {Leg} has the baton and is running!"); 
Random rnd = new Random(); 
int ms = rnd.Next(100, 1000); 
Task.Delay(ms); 
I] BRT 
LegTime = new TimeSpan(0,0,0,0,ms); 
if (Leg == TotalLegs) 
Console.WriteLine($"{Country} has finished the race!"); 
return this; 
} 


} 




















(firstLegRunners) 。 


// 奥运 会 中 的 接力 跑 

string[] countries = { "Russia", "France", "England", "United States", 
"India", "Germany", "China" }; 

Task<RelayRunner>[,] teams = new Task<RelayRunner>[countries.Length, 4]; 

List<Task<RelayRunner>> runners = new List<Task<RelayRunner>>(); 

List<Task<RelayRunner>> firstLegRunners = new List<Task<RelayRunner>>(); 








我 们 将 生成 这 些 集合 和 选手 ， 这 样 每 个 





Pi 











队 的 第 一 棒 起 跑 者 都 有 接力 棒 ， 如 果 选 手 不 是 


Pi 














Drei. Du 


其 起 步 取 决 于 团队 中 的 前 一 个 选手 何 时 完成 (Continuewith), Rin F 


所 示 。 
for (int i = 0; i < countries.Length; i++) 
{ 
for (int r = 0; r < 4; r++) 
{ 
var runner = new RelayRunner() 
{ 
Country = countries[i], 
Leg = r*1, 
HasBaton = r == 0 ? true : false, 
TotalLegs = 4 
P 

















if (r == 0) // 为 每 个 国家 添加 起 跑 者 
{ 


Func«RelayRunner» funcRunner = runner.Sprint; 
teams[i, r] = new Task<RelayRunner>(funcRunner); 
firstLegRunners.Add(teams[i, r]); 








else // 添加 每 个 国家 的 其 他 接力 段 的 选手 
{ 
teams[i, r] = teams[i, r - 1].ContinueWith((lastRunnerRunning) => 


var LastRunner = lastRunnerRunning.Result; 

// 接 棒 

Console.WriteLine(S"([lastRunner.Countryj hands off from " + 
$'"(lastRunner.Leg) to {runner.Leg}!"); 

Random rnd = new Random(); 

int fumbleChance - rnd.Next(0, 10); 

if (fumbleChance » 8) 


Console.WriteLine( 
$"Oh no! {lastRunner.Country} for Leg " + 
$'(runner.Leg) fumbled the hand off from Leg " + 
$"(lastRunner.Leg]!"); 
Thread.Sleep(1000) ; 
Console.WriteLine($"{lastRunner.Country} for Leg " + 
s"{runner.Leg}" + 
" recovered the baton and is running again!"); 
} 
LastRunner .HasBaton = false; 
runner .HasBaton = true; 
return runner.Sprint(); 


5; 
} 
// 添加 到 我 们 的 runners 列 表 中 


runners.Add(teams[i, r]); 





} 


要 模拟 发 令 枪 ， 我 们 将 使 用 Parallel.ForEach 来 调用 每 个 第 一 棒 起 跑 者 任务 的 Start, 1 
通过 简单 循环 相 比 ， 这 样 确保 了 更 多 的 随机 启动 ， 代 码 如 下 所 示 。 


// 发 令 枪 响 以 启动 赛跑 


Parallel.ForEach(firstLegRunners, r => 





r.Start(); 
H); 
最 后 ， 我 们 使 用 所 有 Task<RelayRunner> 任务 的 列表 调用 Task. WattAll 以 等 待 比赛 结束 ， 
代码 如 下 所 示 。 


// 等 待 每 个 人 完成 
Task.WaitAll(runners.ToArray()); 








12.12.3 讨论 

尽管 以 一 定 顺序 运行 任务 通常 来 说 违反 了 并 行 性 ， 因 为 能 够 以 任意 顺序 运行 不 相关 的 任务 
对 可 扩展 性 最 好 ， 但 现实 是 大 多 数 任务 是 有 顺序 的 ， 并 且 能 够 在 代码 中 表示 该 顺序 是 有 
用 的 。ContinueWith 提供 了 一 些 带 有 不 同 参数 的 重 载 以 控制 在 初始 任务 完成 之 后 发 生 的 行 
为 。 表 12-1 列 出 了 作为 参数 可 用 的 控制 结构 类 型 。 
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3212-1: ContinueWith 参 数 









































值 描 Ok 

Action<Task> 初始 任务 完成 之 后 执行 的 动作 。 将 会 把 原始 任务 作为 引用 传 入 
Func<Task, TResult> 初始 任务 完成 之 后 执行 的 函数 。 将 会 把 原始 任务 作为 引用 传 入 
CancellationToken 此 标记 将 赋 给 延续 任务 以 允许 取消 延续 

TaskScheduler 此 任务 使 用 的 调度 器 (与 默认 不 同 ， 如 果 基 于 任务 需要 不 同 的 调度 算法 ) 
Object 传人 到 延续 中 的 状态 对 象 












































若 要 在 比赛 结束 之 后 显示 积分 榜 ， 我 们 使 用 下 面 的 代码 ， 其 中 对 选手 按 团队 分 组 并 使 用 
LINQ 中 的 sum 扩展 方法 累加 他 们 的 时 间 (LegTime) 。 


Console.WriteLine("\r\nRace standings:"); 





var standings = from r in runners 
group r by r.Result.Country into countryTeams 
select countryTeams; 


string winningCountry = string.Empty; 
int bestTime = int.MaxValue; 


HashSet<Tuple<int, string>> place = new HashSet<Tuple<int, string>>(); 
foreach (var team in standings) 


{ 
var time = team.Sum(r => r.Result.LegTime.Milliseconds); 
if (time < bestTime) 
{ 
bestTime = time; 
winningCountry = team.Key; 
} 
place.Add(new Tuple<int, string>(time, 
$'(team.Key) with a time of {time}ms")); 
} 
int p = 1; 
foreach(var item in place.OrderBy(t => t.Item1)) 
{ 
Console.WriteLine($"{p}: {item.Item2}"); 
ptt; 
} 


Console.WriteLine($"\n\nThe winning team is from {winningCountry}"); 


比赛 的 输出 如 下 所 示 。 


France for Leg 1 has the baton and is running! 

United States for Leg 1 has the baton and is running! 
Russia for Leg 1 has the baton and is running! 

England for Leg 1 has the baton and is running! 

France hands off from 1 to 2! 

England hands off from 1 to 2! 

Russia hands off from 1 to 2! 

United States hands off from 1 to 2! 

Russia for Leg 2 has the baton and is running! 

Oh no! England for Leg 2 fumbled the hand off from Leg 1! 








Oh no! France for Leg 2 fumbled the hand off from Leg 1! 
United States for Leg 2 has the baton and is running! 
Russia hands off from 2 to 3! 

United States hands off from 2 to 3! 

Russia for Leg 3 has the baton and is running! 

Russia hands off from 3 to 4! 

United States for Leg 3 has the baton and is running! 
Russia for Leg 4 has the baton and is running! 

United States hands off from 3 to 4! 

United States for Leg 4 has the baton and is running! 
United States has finished the race! 

Russia has finished the race! 

Germany for Leg 1 has the baton and is running! 
Germany hands off from 1 to 2! 

Germany for Leg 2 has the baton and is running! 
Germany hands off from 2 to 3! 

Germany for Leg 3 has the baton and is running! 

India for Leg 1 has the baton and is running! 

India hands off from 1 to 2! 

India for Leg 2 has the baton and is running! 

Germany hands off from 3 to 4! 

Germany for Leg 4 has the baton and is running! 

India hands off from 2 to 3! 

India for Leg 3 has the baton and is running! 

India hands off from 3 to 4! 

India for Leg 4 has the baton and is running! 

India has finished the race! 

China for Leg 1 has the baton and is running! 

Germany has finished the race! 

China hands off from 1 to 2! 

China for Leg 2 has the baton and is running! 

China hands off from 2 to 3! 

China for Leg 3 has the baton and is running! 

China hands off from 3 to 4! 

China for Leg 4 has the baton and is running! 

China has finished the race! 

France for Leg 2 recovered the baton and is running again! 
France for Leg 2 has the baton and is running! 

France hands off from 2 to 3! 

France for Leg 3 has the baton and is running! 

France hands off from 3 to 4! 

France for Leg 4 has the baton and is running! 

France has finished the race! 

England for Leg 2 recovered the baton and is running again! 
England for Leg 2 has the baton and is running! 
England hands off from 2 to 3! 

England for Leg 3 has the baton and is running! 
England hands off from 3 to 4! 

England for Leg 4 has the baton and is running! 
England has finished the race! 


Race standings: 

1: India with a time of 696ms 
2: Germany with a time of 698ms 
3: China with a time of 699ms 
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Russia with a time of 1510ms 
United States with a time of 1540ms 
France with a time of 2659ms 
England with a time of 3625ms 


NOW A 


The winning team is from India 


12.12.4 参考 


MSDN Xx #4 H ÁJ *Task.ContinueWith" "Task.WaitAll" fN “Parallel.ForEach” + yi, DA 




















及 Stephen Cleary HY (CH 并 发 编程 经 典 实例 》。 
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13.0 简介 

每 个 程序 员 都 有 一 些 不 断 参 考 并 使 用 的 例 程 。 这 些 工 具 函 数 通 常 是 一 些 未 由 任何 特定 语言 
或 框架 提供 的 代码 。 本 章 汇 编 了 我 们 在 使 用 CH 和 NET Framework 过 程 中 收集 的 实用 工具 
例 程 。 我 们 在 本 章 中 共享 的 各 类 内 容 包 括 以 下 这 些 。 

。 电源 管理 事件 

。 确定 操作 系统 中 各 个 位 置 的 路 径 

。 与 服务 交互 

检查 全 局 程序 集 缓 存 (GAC) 

消息 队列 


这 是 你 在 开发 自己 应 用 程序 中 的 大 量 功能 集 时 帮助 解决 特定 需求 的 各 种 代码 汇集 。 
13.1 处 理 操作 系统 关机 、 电 源 管理 或 用 户 会 话 
变化 


13.1.1 问题 


你 希望 在 操作 系统 或 用 户 启 动 某 个 要 求 你 的 应 用 程序 关闭 或 停止 的 操作 (用 户 注销 、 远 程 
会 话 断 开 、 系 统 关 机 、 休 眠 /恢复 ， 等 等 ) 时 得 到 通知 。 有 了 这 个 通知 之 后 ， 你 可 以 使 你 
的 应 用 程序 优雅 地 啊 应 变化 。 
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13.1.2 ”解决 方案 

使 用 Microsoft.Win32.SystemEvents 类 获得 操作 系统 、 用 户 会 话 修改 以 及 电源 管理 事件 的 
通知 。 接 下 来 所 示 的 RegisterForSystemEvents 方法 挂 接 五 个 捕获 这 些 事 件 必 需 的 事件 处 理 
程序 ， 并 且 应 该 将 该 方法 放置 在 代码 的 初始 化 部 分 中 。 


public static void RegisterForSystemEvents() 


{ 











// 始终 在 事件 线程 关闭 时 得 到 最 终 通 知 以 便 注 销 
SystemEvents.EventsThreadShutdown += 

new EventHandler(OnEventsThreadShutdown); 
SystemEvents.PowerModeChanged += 

new PowerModeChangedEventHand Ler (OnPowerModeChanged) ; 
SystemEvents.SessionSwitch += 

new SessionSwitchEventHandler(OnSessionSwitch); 
SystemEvents.SessionEnding += 

new SessionEndingEventHandler(OnSessionEnding); 
SystemEvents.SessionEnded += 

new SessionEndedEventHandler(OnSessionEnded); 














} 


EventsThreadShutdown 事件 在 分 发 来 自 SystemEvents 类 的 事件 的 线程 关闭 时 通知 你 ， 因 此 
你 可 以 在 SystemEvents 类 上 注销 尚未 注销 的 事件 。PowerModeChanged 事件 在 用 户 挂 起 系统 
或 从 被 挂 起 状态 恢复 系统 时 触发 。Sessionswitch 事件 在 登录 用 户 变化 时 触发 。 当 用 户 试 
图 登 出 或 关闭 系统 时 触发 SessionEnding 事件 ， 而 SessionEnded 事件 在 用 户 实际 登 出 或 关 
闭 系统 时 触发 。 

可 以 使 用 UnregisterFromSystemEvents 方法 注销 事件 。UnregisterFromSystemEvents 应 当 在 
Windows Forms、 用 户 控件 或 者 任何 其 他 来 来 往往 的 类 终止 代码 中 调用 ， 以 及 在 范例 13.2 
(BJ 13.2 节 ) 中 显示 的 另 一 个 区 域 中 调用 。 


private static void UnregisterFromSystemEvents() 


{ 
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SystemEvents.EventsThreadShutdown -- 

new EventHandler(OnEventsThreadShutdown); 
SystemEvents.PowerModeChanged -- 

new PowerModeChangedEventHandler(OnPowerModeChanged); 
SystemEvents.SessionSwitch -= 

new SessionSwitchEventHandler(OnSessionSwitch); 
SystemEvents.SessionEnding -- 

new SessionEndingEventHandler(OnSessionEnding); 
SystemEvents.SessionEnded -- 

new SessionEndedEventHandler(OnSessionEnded); 


由 于 SystemEvents 公开 的 事件 是 静态 的 ， 如 果 你 在 一 段 可 能 被 多 次 调用 的 代 
码 中 使 用 它们 (次 级 Windows Forms、 用 户 控件 、 监 控 类 等 )， 那 么 必须 注 
销 自己 的 处 理 程序 ， 否 则 将 会 导致 应 用 程序 的 内 存 泄漏 。 
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SystemEvents 事件 处 理 程序 方法 是 用 于 每 个 已 在 RegisterForSystemEvents rp iT pal Ay 3 4 



































的 独立 处 理 程序 。 要 介绍 的 第 一 个 处 理 程序 是 OnEventsThreadShutdown 处 理 程序 。 如 果 该 
事件 被 激发 ， 那 么 注销 处 理 程序 是 很 重要 的 ， 因 为 用 于 SystemEvents 类 的 通知 终 程 正在 停 
止 ， 而 且 该 类 可 能 在 你 的 应 用 程序 之 前 结束 。 如 果 在 该 时 间 点 之 前 不 注销 ， 将 会 导致 内 存 
泄漏 。 因 此 ， 要 在 此 事件 处 理 程 序 中 添加 对 UnregisterFromSystemEvents 的 调用 ， 代 码 如 
下 所 示 。 


private static void OnEventsThreadShutdown(object sender, EventArgs e) 


{ 















































Debug .WriteLine( 
"System event thread is shutting down, no more notifications."); 


// 注销 所 有 事件 处 理 , 因 为 通知 线程 就 要 结束 


UnregisterFromSystemEvents(); 











} 
下 一 个 要 探索 的 处 理 程序 是 onpowerwodechanged 方法 。 该 处 理 程序 可 以 通过 PowerMode- 
ChangedEventArgs 参数 的 Mode 属性 报告 电源 管理 事件 的 类 型 。Mode 属性 具有 PowerMode 枚 
举 类 型 ， 通 过 其 包含 的 枚 举 值 指定 事件 类 型 。 


private static void OnPowerModeChanged(object sender, 
PowerModeChangedEventArgs e) 
































{ 
// 电源 模式 在 变化 
switch (e.Mode) 


{ 





case PowerModes.Resume: 
Debug.WriteLine("PowerMode: OS is resuming from suspended state"); 
break; 
case PowerModes.StatusChange: 
Debug. WriteLine( 
"PowerMode: There was a change relating to the power" + 
" supply (weak battery, unplug, etc..)"); 
break; 
case PowerModes. Suspend: 
Debug.WriteLine("PowerMode: OS is about to be suspended"); 
break; 


} 


接 下 来 的 三 个 处 理 程序 用 来 处 理 操作 系统 会 话 状态 ， 它 们 是 OnSessionSwitch, OnSession- 
Ending 和 0nsessionEnded。 处 理 这 三 种 事件 覆盖 了 应 用 程序 可 能 需要 关心 的 所 有 操作 系 
统 会 话 状态 转变 。 在 OnSessionEnding 中 有 一 个 SessionEndingEventArgs 参数 ， 它 有 一 个 
Cancel 成 员 。 通 过 将 Cancel 成 员 设 置 为 false， 允 许 你 请 求 会 话 不 要 终止 。 用 于 这 三 个 处 
理 程序 的 代码 如 例 13-1 所 示 。 


例 13-1: OnSessionSwitch, OnSessionEnding 和 OnSessionEnded 处 理 程序 
private static void OnSessionSwitch(object sender, SessionSwitchEventArgs e) 
































// 检查 原因 


switch (e.Reason) 


{ 





case SessionSwitchReason.ConsoleConnect: 








Debug.WriteLine("Session connected from the console"); 
break; 

case SessionSwitchReason.ConsoleDisconnect: 
Debug.Writeline("Session disconnected from the console"); 
break; 

case SessionSwitchReason.RemoteConnect: 
Debug.WriteLine("Remote session connected"); 
break; 

case SessionSwitchReason.RemoteDisconnect: 
Debug.WriteLine("Remote session disconnected"); 
break; 

case SessionSwitchReason.SessionLock: 
Debug.WriteLine("Session has been locked"); 
break; 

case SessionSwitchReason.SessionLogoff: 
Debug.WriteLine("User was logged off from a session"); 
break; 

case SessionSwitchReason.SessionLogon: 
Debug.WriteLine("User has logged on to a session"); 
break; 

case SessionSwitchReason.SessionRemoteControl: 
Debug.WriteLine("Session changed to or from remote status"); 
break; 

case SessionSwitchReason.SessionUnlock: 
Debug.WriteLine("Session has been unlocked"); 
break; 


j 


private static void OnSessionEnding(object sender, SessionEndingEventArgs e) 


{ 














// 设 为 true 以 取消 结束 会 话 的 用 户 请 求 ,否则 设 为 false 
e.Cancel = false; 


// 检查 原因 


switch(e.Reason) 


{ 








case SessionEndReasons.Logoff: 
Debug.WriteLine("Session ending as the user is logging off"); 
break; 

case SessionEndReasons.SystemShutdown: 
Debug.WriteLine("Session ending as the OS is shutting down"); 
break; 


j 


private static void OnSessionEnded(object sender, SessionEndedEventArgs e) 
{ 
switch (e.Reason) 
{ 
case SessionEndReasons.Logoff: 
Debug.WriteLine("Session ended as the user is logging off"); 
break; 
case SessionEndReasons.SystemShutdown: 
Debug.WriteLine("Session ended as the OS is shutting down"); 
break; 





13.1.3 讨论 


.NET Framework 提供 了 当 用 户 或 系统 交互 引起 改变 时 从 系统 中 获得 反馈 的 机 会 。 
SystemEvents 类 公开 的 事件 比 本 范例 中 使 用 的 要 多 。 关 于 它们 的 完整 列表 ， 参 见 表 13-1。 


表 13-1: SystemEvents 事 件 





























值 描 xh 
DisplaySettingsChanged 用 户 修改 了 显示 设置 
DisplaySettingsChanging 显示 设置 正在 改变 
EventsThreadShutdown 侦 听 系统 事件 的 线程 正在 终止 
InstalledFontsChanged 用 户 添加 或 移 除 了 字体 
paletteChanged 用 户 切 换 到 使 用 其 他 调 色 板 的 应 用 程序 
PowerModeChanged 用 户 挂 起 或 恢复 了 系统 
SessionEnded 用 户 关闭 系统 或 者 注销 
SessionEnding 用 户 尝试 关闭 系统 或 者 注销 
SessionSwitch 改变 了 当前 登录 用 户 
TimeChanged 用 户 更 改 了 系统 时 间 
TimerElapsed Windows 计时 器 间隔 过 期 
UserPreferenceChanged 用 户 更 改 了 系统 中 的 首选 项 
UserPreferenceChanging 用 户 正 试图 修改 系统 中 的 首选 项 








来 自 SystemEvents 的 通知 从 专门 用 于 引发 这 些 事 伯 
使 用 任何 信息 更 新 UI 前 ， 都 需要 回 到 正确 的 用 户 界 国 



































使 系统 能 








要 谨 记 ， 这 些 是 系统 事件 。 因 此 ， 在 处 理 程序 中 完成 的 工作 应 当 尽 量 少 ， 以 
够 继续 进行 下 一 项 任务 。 


F 的 线程 中 发 出 。 在 UI 应 用 程序 中 ， 在 














BeginInvoke、Control.Inovke 或 者 BackgroundWorker) 之 一 来 完成 此 操作 。 


请 注意 ， 在 编写 本 书 时 ，.NET Core (用 于 跨 平台 玫 








ij 线程 中 。 使 用 几 个 方法 (Control. 


F 发 的 开源 版 本 NET) 不 包括 Microsoft. 


Win32.SystemEvents 类 ， 因 此 这 个 范例 将 不 能 工作 于 .NET Core， 直 到 有 人 添加 了 它 为 止 。 


13.1.4 参考 


MSDN 文档 中 的 “SystemEvents 类 ”“PowerModeChangedEventArgs 类 ”“SessionEndedEventArgs 
2" "SessionEndingEventArgs 类 ”和 “SessionSwitchEventArgs 类 ”主题 。 











13.2 ”控制 系统 服务 


13.2.1 问题 
你 需要 通过 编程 方式 操作 应 用 程序 与 之 交互 的 服务 。 


13.2.2 ”解决 方案 


使 用 System.ServiceProcess.ServiceController 类 控制 服务 。ServiceController 人 允许 你 与 
一 个 已 有 的 服务 进行 交互 并 读 取 和 修改 其 属性 。 在 示例 中 ， 它 将 用 于 操作 ASP.NET 状态 
服务 。 其 名 称 、 服 务 类 型 和 显示 名 称 很 容易 从 ServiceName, ServiceType 和 DisplayName 
属性 得 到 。 
ServiceController scStateService = new ServiceController("COM+ Event System"); 
Console.WriteLine($"Service Type: {scStateService.ServiceType.ToString()}"); 


Console.WriteLine($"Service Name: {scStateService.ServiceName}") ; 
Console.WriteLine($"Display Name: {scStateService.DisplayName}") ; 


ServiceType 枚 举 有 一 些 值 ， 如 表 13-2 所 示 。 
表 13-2: ServiceType 枚 举 值 


fü 描 述 

Adapter 用 于 硬件 设备 的 服务 
FileSystemDriver 文件 系统 驱动 (内 核 级 别 ) 
InteractiveProcess 与 桌面 进行 通信 的 服务 
































KernelDriver 低级 别 的 硬件 设备 驱动 

RecognizerDriver 在 启动 时 用 于 确定 文件 系统 的 驱动 

Win320wnProcess 作为 一 项 服务 在 其 独立 进程 中 运行 的 Win32 程序 
Win32ShareProcess 作为 一 项 服务 在 共享 进程 (如 SvcHost) 中 运行 的 Win32 程序 











确定 一 个 服务 的 依赖 性 服务 是 一 项 非常 有 用 的 任务 。 依 赖 当 前 服务 的 服务 可 通过 
DependentServices 属性 进行 访问 ， 它 是 一 个 ServiceController 实例 数组 (每 个 实例 对 应 
一 个 依赖 服务 ) 。 

foreach (ServiceController sc in scStateService.DependentServices) 


Console.WriteLine($"{scStateService.DisplayName} is depended on by: " + 
$" (sc.DisplayName]"); 


+H EE ifii =, ServicesDependedOn 数组 包含 当前 服务 依赖 的 每 一 个 服务 对 应 的 Service- 
Controller 实例 。 
foreach (ServiceController sc in scStateService.ServicesDependedOn) 


Console.WriteLine( 
$"(scStateService.DisplayName) depends on: {sc.DisplayName}") ; 


关于 服务 最 重要 的 事情 之 一 就 是 它们 所 处 的 状态 。 如 果 一 个 服务 被 期 望 运行 而 没有 运行 ， 
或 者 更 糟 的 是 期 望 禁 用 它 (可 能 因为 一 个 安全 风险 ) 而 实际 没有 禁用 它 ， 那 么 它 不 会 起 到 














很 好 的 作用 。 要 找 出 当前 服务 状态 ， 可 检查 Status 属性 。 对 此 例 来 说 ， 服 务 的 原始 状态 将 
被 保存 ， 以 便 随 后 从 originalstate 变量 中 恢复 它 。 

Console.WriteLine($"Status: {scStateService.Status}"); 

// 保存 原始 状态 

ServiceControllerStatus originalState = scStateService.Status; 
既然 我 们 已 经 建立 了 合适 的 访问 ， 就 可 以 开始 使 用 服务 的 方法 。 如 果 服 务 停止 ， 那 么 可 以 
使 用 Start 方法 启动 它 。 首 先 ， 检 查 服 务 是 否 停 止 ， 然 后 ,一旦 在 ServiceController 3; 
例 上 调用 了 start， 调 用 WaitForStatus 方法 以 确保 服务 启动 。WaitForsStatus 可 以 接受 一 
个 超时 值 ， 使 应 用 程序 不 必 在 出 现 问 题 时 永远 等 待 服务 启动 。 


TimeSpan serviceTimeout = TimeSpan.FromSeconds(60); 


// 如 果 服 务 停止 了 , 启动 


if (scStateService.Status == ServiceControllerStatus. Stopped) 


( 























Gr 


scStateService.Start(); 

// 等 待 服务 启动 ,最 多 等 60 秒 

scStateService.WaitForStatus(ServiceControllerStatus.Running, 
serviceTimeout) ; 


} 


Console.WriteLine($"Status: {scStateService.Status}"); 
服务 也 可 以 暂停 。 如 果 服 务 被 暂停 ， 那 么 应 用 程序 需要 通过 查看 CanPauseAndContinue 
属性 检查 是 否 能 够 继续 运行 它 。 如 果 可 以 ，Continue 方法 将 再 次 令 服务 运行 ， 而 
WaitForStatus 方法 应 当 被 调用 以 等 待 服务 运行 ， 代 码 如 下 所 示 。 

// 如 果 服 务 暂停 了 ,恢复 运行 




















if (scStateService.Status == ServiceControllerStatus.Paused) 
{ 
if (scStateService.CanPauseAndContinue) 
{ 
scStateService.Continue(); 
// 等 待 服务 启动 ,最 多 等 60 秒 
scStateService.WaitForStatus(ServiceControllerStatus.Running, 
serviceTimeout) ; 
} 


} 


Console.WriteLine($"Status: {scStateService.Status}"); 
// 服务 此 时 应 该 已 在 运行 


确定 一 种 服务 能 否 被 停止 可 通过 CanStop 属性 来 完成 。 如 果 它 能 被 停止 ， 则 需要 调用 Stop 
方法 以 及 WaitForSstatus， 代 码 如 下 所 示 。 


// 是 否 能 够 停止 服务 
if (scStateService.CanStop) 




















{ 
scStateService.Stop(); 
// 等 待 服务 停止 ,最 多 等 69 秒 
scStateService.WaitForStatus(ServiceControllerStatus.Stopped, 
serviceTimeout); 
} 


Console.WriteLine($"Status: {scStateService.Status}"); 


























即使 CanStop 可 能 返回 true， 如 果 我 们 没有 在 管理 上 下 文中 运行 ， 就 会 在 试图 停止 服务 时 
得 到 以 下 异常 。 
A first chance exception of type 'System.InvalidOperationException' occurred in 


System. ServiceProcess.dll 
Additional information: Cannot open EventSystem service on computer 


请 参阅 讨论 部 分 中 如 何 为 代码 设置 适当 的 安全 访问 权限 。 
现在 是 时 候 将 服务 设置 回 当 初 的 状态 了。originalstate 变量 持 有 原始 状态 ， 而 switch iE 
句 包含 将 服务 从 当前 停止 的 状态 设置 为 原始 状态 的 动作 。 

// 将 服务 设置 回 原始 状态 


switch (originalState) 
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{ 
case ServiceControllerStatus. Stopped: 
if (scStateService.CanStop) 
scStateService.Stop(); 
break; 
case ServiceControllerStatus.Running: 
scStateService.Start(); 
// BAERS AD) ie de 60b 
scStateService.WaitForStatus(ServiceControllerStatus.Running, 
serviceTimeout) ; 
break; 
case ServiceControllerStatus.Paused: 
// 如 果 原 来 是 暂停 ,但 现在 被 停止 了 ,需要 先 重新 启动 再 暂停 
if (scStateService.Status == ServiceControllerStatus.Stopped) 
{ 
scStateService.Start(); 
// 等 待 服务 启动 ,最 多 等 69 秒 
scStateService.WaitForStatus(ServiceControllerStatus.Running, 
serviceTimeout); 
} 
// 然后 暂停 
if (scStateService.CanPauseAndContinue) 
{ 
scStateService.Pause(); 
// 等 待 服务 停止 ,最 多 等 66 秒 
scStateService.WaitForStatus(ServiceControllerStatus.Paused, 
serviceTimeout) ; 
} 
break; 
} 


为 了 确保 服务 上 的 Status 属性 是 正确 的 ， 应 用 程序 应 当 在 测试 status 属性 值 之 前 调用 
Refresh 对 其 进行 更 新 。 一 旦 应 用 程序 完成 对 服务 的 使 用 ， 就 调用 Close 方法 。 


scStateService.Refresh(); 
Console.WriteLine($"Status: {scStateService.Status.ToString()}"); 














// 关 闭 它 


scStateService.Close(); 





13.2.3 ”讨论 


现在 ， 服 务 运 行 许多 操作 系统 功能 。 它 们 通常 在 某 个 系统 账户 (LocalSystem, Network- 
Service, LocalService) 下 或 者 某 个 已 被 赋予 指定 许可 和 权限 的 特定 用 户 账户 下 运行 。 如 
果 你 的 应 用 程序 使 用 一 个 服务 ， 那 么 这 是 在 用 户 程 序 试图 使 用 它 之 前 ， 确 定 用 于 运行 该 服 
务 的 所 有 工作 是 否 已 建立 并 正确 配置 的 一 个 好 方法 。 并 不 是 所 有 应 用 程序 都 直接 依赖 服 
务 。 但 如 果 你 的 应 用 程序 直接 依赖 服务 ， 或 者 你 已 经 编写 了 一 个 服务 作为 应 用 程序 的 一 部 
分 ， 那 么 存在 一 种 简单 的 方法 去 检查 服务 的 状态 并 且 纠 正 可 能 的 情况 就 很 方便 了 。 


当 你 在 操作 服务 时 ， 就 会 遇 到 访问 权限 问题 了 。 虽 然 在 早期 的 Microsoft 操作 系统 
(Windows 7 之 前 ) 中 你 可 以 调用 ServiceController API 而 无 需 任 何 特定 权限 ， 随 着 用 户 
账户 控制 (user account control, UAC) 的 引入 ,现在 必须 要 在 管理 上 下 文中 才能 访问 影响 
服务 运行 的 方法 。 你 依然 无 需 此 访问 级 别 就 可 以 查看 服务 的 属性 ， 但 如 果 想 要 启动 、 停 止 
等 ， 就 需要 提升 权限 。 


要 在 代码 中 做 到 这 一 点 ， 可 以 将 一 个 app.manifest 文件 添加 到 应 用 程序 ， 通 过 右键 单 击 项 
目 并 选择 Add*New Item (添加 新 项 目 )， 然 后 选择 Application Manifest File (应 用 程序 清 
单 文件 )， 如 图 13-1 所 示 。 
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& 13-1; Application Manifest File 创建 窗口 





在 此 文件 的 asmv1:assembly\trustinfo\security\requestedPrivileges 节 ， 默 认 请 求 的 执行 级 别 是 
以 调用 代码 的 用 户 来 运行 。 


<requestedExecutionLevel level="asInvoker" uiAccess="false" /> 
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要 允许 访问 服务 方法 ， 可 以 通过 把 level 属性 设置 为 requtreAdmintstrator， 以 使 代码 需 
要 管理 上 下 文 。 
<!-- 对 于 范例 13.2( 即 13.2 节 ) :控制 服务 中 的 服务 交互 是 必需 的 --> 


«requestedExecutionLevel level-"requireAdministrator" uiAccess="false"/> 


这 将 确保 当代 码 运行 时 ， 它 要 求 用 户 具有 足够 的 权限 来 执行 我 们 所 请 求 的 行为 。 


13.2.4 ”参考 


MSDN 文档 中 的 “ServiceControl 类 ”和 “ServiceControllerStatus 枚 举 ” 主 题 。 


13.3 ” 列 出 加 载 一 个 程序 集 的 进程 


13.3.1 问题 
你 希望 知道 当前 哪些 进程 加 载 了 某 个 给 定 程序 集 。 


13.3.2 ”解决 方案 


使 用 我 们 为 此 目的 而 创建 的 GetProcessesAssemblyIsLoadedIn 方法 返回 一 个 加 载 了 给 定 程 
序 集 的 进程 列表 。GetProcessesAssemblyIsLoadedIn 获取 程序 集 的 文件 名 (如 mscoree.dll) 
以 进行 查找 ， 然 后 通过 调用 Process.GetProcesses 获得 机 器 上 当前 运行 的 进程 列表 。 然 后 
它 搜索 进程 ， 查 看 程序 集 是 否 加 载 到 它们 之 中 。 如 果 在 某 一 进程 中 找到 程序 集 ， 那 么 就 将 
该 Process 对 象 投 影 到 一 个 Process 对 象 的 可 枚 举 集合 。 从 查询 中 返回 所 发 现 的 进程 集合 
H3 ai o 
public static IEnumerable«Process» GetProcessesAssemblyIsLoadedIn( 
string assemblyFileName) 












































{ 
// System 和 IdLe 并 不 算 真正 的 进程 ， 
// 所 以 它们 没有 关联 任何 模块 , 跳 过 它们 
var processes = from process in Process.GetProcesses() 
where process.ProcessName != "System" && 
process.ProcessName != "Idle" 
from ProcessModule processModule in process. SafeGetModules() 
where processModule.ModuleName.Equals(assemblyFileName, 
StringComparison.OrdinallgnoreCase) 
select process; 
return processes; 
} 

















Process .GetSafeModules 扩展 方法 获取 调用 者 被 授权 可 见 的 模块 列表 。 如 果 我 们 只 是 直接 
访问 Modules 属性 ， 会 得 到 一 系列 不 同 的 访问 错误 ， 有 具体 取决 于 调用 者 的 安全 上 下 文 。 


public static ProcessModuleCollection SafeGetModules(this Process process) 


{ 


List«ProcessModule» listModules = new List<ProcessModule>(); 





ProcessModuleCollection modules = 
new ProcessModuleCollection(listModules.ToArray()); 


try 
{ 


} 

catch (InvalidOperationException) { } 
catch (PlatformNotSupportedException) { } 
catch (NotSupportedException) { } 

catch (Win32Exception wex) 


{ 


modules = process.Modules; 


Console.WriteLine($"Couldn't get modules for {process.ProcessName}: " + 
S"{wex.Message}"); 
} 
// 返回 模块 集合 或 者 一 个 空 集 合 


return modules; 





13.3.3 ”讨论 


TESLA OLD, (phu BE RRM APSE, A3 1 ERU ee OBA & PE 
程 中 是 很 有 益 的 。 通 过 快速 获取 程序 集 被 加 载 到 的 Process 对 象 列表 ， 你 能 够 缩小 研究 的 
范围 。 


下 列 代 码 使 用 这 一 例 程 查找 .NET 进程 。 


string searchAssm = "mscoree.dll"; 
var processes = GetProcessesAssemblyIsLoadedIn(searchAssm); 
foreach (Process p in processes) 
Console.WriteLine($"Found {searchAssm} in {p.MainModule.ModuleName}") ; 


当 你 运行 GetProcessesAssemblyIsLoadedIn 方法 时 ， 用 户 的 安全 上 下 文 对 于 代码 能 发 现 多 
少 进程 起 了 很 大 的 作用 。 如 果 调 用 方 是 不 在 管理 上 下 文 〈 它 必须 由 用 户 显 式 进入 ) 中 运行 
的 普通 Windows 用 户 ， 你 会 看 到 一 些 进程 报告 说 不 能 检查 它们 的 模块 ， 如 例 13-2 所 示 。 


例 13-2: 普通 用 户 安全 上 下 文 输出 示例 
Couldn't get modules for dasHost: Access is denied 
Couldn't get modules for WUDFHost: Access is denied 
Couldn't get modules for StandardCollector.Service: Access is denied 
Couldn't get modules for winlogon: Access is denied 
Couldn't get modules for svchost: Access is denied 
Couldn't get modules for FcsSas: Access is denied 
Couldn't get modules for VBCSCompiler: Access is denied 
Couldn't get modules for svchost: Access is denied 
Couldn't get modules for coherence: Access is denied 
Couldn't get modules for coherence: Access is denied 
Couldn't get modules for svchost: Access is denied 
Couldn't get modules for MOMService: Access is denied 
Couldn't get modules for svchost: Access is denied 
Couldn't get modules for csrss: Access is denied 
Couldn't get modules for svchost: Access is denied 
Couldn't get modules for vmms: Access is denied 


















































Couldn't get modules 
Found mscoree.dll in 
Couldn't get modules 
Couldn't get modules 
Couldn't get modules 
Couldn't get modules 
Couldn't get modules 
Couldn't get modules 
Couldn't get modules 
Couldn't get modules 
Couldn't get modules 
Couldn't get modules 
Couldn't get modules 
Couldn't get modules 
Couldn't get modules 
Couldn't get modules 
Found mscoree.dll in 
Couldn't get modules 
Couldn't get modules 
Couldn't get modules 
Couldn't get modules 
Couldn't get modules 
Found mscoree.dll in 
Couldn't get modules 
Couldn't get modules 
Couldn't get modules 
Couldn't get modules 
Couldn't get modules 
Found mscoree.dll in 
Couldn't get modules 
Couldn't get modules 
Couldn't get modules 
Couldn't get modules 
Couldn't get modules 
Couldn't get modules 
Couldn't get modules 
Couldn't get modules 
Couldn't get modules 
Couldn't get modules 
Couldn't get modules 
Couldn't get modules 


for dwm: Access is denied 
Microsoft.VsHub.Server.HttpHostx64.exe 
for wininit: Access is denied 
for svchost: Access is denied 
for prl tools: Access is denied 
for coherence: Access is denied 
for MpCmdRun: Access is denied 
for svchost: Access is denied 
for svchost: Access is denied 
for audiodg: Access is denied 
for mqsvc: Access is denied 

for WmiApSrv: Access is denied 
for conhost: Access is denied 
for sqlwriter: Access is denied 
for svchost: Access is denied 
for svchost: Access is denied 
CSharpRecipes.exe 

for WmiPrvSE: Access is denied 
for spoolsv: Access is denied 
for svchost: Access is denied 
for WmiPrvSE: Access is denied 
for svchost: Access is denied 
msvsmon.exe 

for csrss: Access is denied 

for dllhost: Access is denied 
for svchost: Access is denied 
for SearchIndexer: Access is denied 
for WmiPrvSE: Access is denied 
VBCSCompiler .exe 

for svchost: Access is denied 
for OSPPSVC: Access is denied 
for WmiPrvSE: Access is denied 
for smss: Access is denied 

for IpOverUsbSvc: Access is denied 
for lsass: Access is denied 

for services: Access is denied 
for MsMpEng: Access is denied 
for msdtc: Access is denied 

for prl_tools_service: Access is denied 
for inetinfo: Access is denied 
for sppsvc: Access is denied 





当 我 们 在 管理 上 下 文中 运 
于 例 13-3 的 输出 。 





Z íT FÁJ GetProcessesAssemblyIsLoadedIn 调用 时 ， 将 得 到 类 似 





例 13-3: 管理 用 户 安全 上 下 文 输出 示例 


Found mscoree.dLL in 
Found mscoree.dLL in 
Found mscoree.dLL in 
Found mscoree.dll in 
Couldn't get modules 
Found mscoree.dll in 
Couldn't get modules 


VBCSCompiler.exe 
Microsoft.VsHub.Server.HttpHostx64.exe 
msvsmon.exe 

VBCSCompiler .exe 

for audiodg: Access is denied 
ElevatedPrivilegeActions.vshost.exe 
for sppsvc: Access is denied 


因为 这 是 一 个 诊断 函数 ， 你 将 会 需要 FullTrust 安全 访问 来 使 用 该 方法 。 
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注意 查询 跳 过 了 System 和 Idle 进程 的 检查 ， 代 码 如 下 所 示 。 


var processes = from process in Process.GetProcesses() 
where process.ProcessName != "System" && 
process.ProcessName != "Idle" 
from ProcessModule processModule in process.SafeGetModules() 
where processModule.ModuleName.Equals(assemblyFileName, 
StringComparison.OrdinallgnoreCase) 
select process; 


Modules 集合 不 能 用 于 检查 这 两 个 进程 ， 因 为 这 样 做 会 引发 一 个 Win32Exception, F5 

外 两 个 进程 ， 你 可 能 也 会 看 到 访问 被 拒绝 : audiodg 和 sppsvc。 

e audiodg 是 一 个 受 DRM 保护 的 进程 ， 用 于 音频 驱动 程序 的 宿主 ， 以 便 这 些 音 频 驱 动 程 
序 能 够 在 与 本 地 登录 的 用 户 隔 离开 的 登录 会 话 中 运行 。 

。 sppsvc 是 一 个 Microsoft 软件 保护 平台 服务 ， 用 来 防止 使 用 未 经 许可 的 软件 。 

由 于 这 两 个 服务 在 操作 系统 中 都 是 很 敏感 的 ， 你 会 明白 它们 为 什么 无 法 通过 Process 枚 举 

访问 。 














13.3.4 ”参考 


MSDN 文档 中 的 “Process 2E” "ProcessModule 类 ”和 “GetProcesses 方法 ”主题 。 


13.4 使 用 本 地 工作 站 上 的 消息 队列 


13.4.1 问题 


你 需要 一 种 断 开 应 用 程序 中 的 两 个 组 件 (例如 一 个 Web 服务 端点 和 处 理 逻 辑 ) 的 方法 ， 使 
得 第 一 个 组 件 只 需 关 心 格式 化 指令 。 这 样 ， 批 处 理 可 以 发 生 在 第 二 个 组 件 上 。 


13.4.2 ”解决 方案 


使 用 消息 队列 来 分 隔 工 作 ， 在 第 一 个 和 第 二 个 组 件 中 使 用 此 处 展示 的 MQWorker 类 向 一 个 关 
联 的 消息 队列 写 入 或 从 中 读 取消 息 。 


消息 队列 在 各 方 之 间 提 供 异 步 通信 协议 ， 意 味 着 消息 的 发 送 方 和 接收 方 不 需 
要 在 同一 时 间 与 消息 队列 进行 交互 。 放 置 到 队列 上 的 消息 被 存储 ， 直 到 接收 
方 获 取 它 们 。 消 息 队 列 确保 消息 不 会 丢失 ， 将 工作 进行 分 割 ， 处 理 不 一 致 的 
负载 ， 并 且 通 过 多 个 工作 者 从 一 个 队列 中 读 取 来 扩展 你 的 应 用 程序 。 
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MQWorker 使 用 本 地 消息 排队 服务 来 存储 和 获取 消息 。 队 列 路 径 名 在 构造 函数 中 提供 ， 并 且 
在 SetUpQueue 方法 中 检查 队列 是 否 存在 ， 代 码 如 下 所 示 。 


class MQWorker : IDisposable 
{ 


private bool _disposed; 











private string _mqPathName; 
MessageQueue _queue; 


public MQWorker(string queuePathName) 


{ 
if (string.IsNullOrEmpty(queuePathName)) 
throw new ArgumentNullException(nameof(queuePathName)); 
_mqPathName = queuePathName; 
SetUpQueue() ; 
} 





如 果 同 名 队列 不 存在 ，SetUpQueue 使 用 MessageQueue 类 创建 一 个 指定 名 称 的 消息 队列 。 它 




















处 





E 消 息 队 列 服 务 在 工作 站 计算 机 上 运行 的 情况 。 在 此 情况 下 ， 它 使 队列 私有 化 ， 这 是 工 


作 站 上 允许 的 唯一 队列 类 型 。 





private void SetUpQueue() 





// 检查 队列 是 否 存在 ,不 存在 就 创建 它 
if (!MessageQueue.Exists(_mqPathName) ) 


{ 





try 
{ 


j 


catch (MessageQueueException mqex) 


queue = MessageQueue.Create( mgPathName); 


// 检查 是 否 在 一 台 工 作 组 的 计算 机 上 运行 
if (mqex.MessageQueueErrorCode == 
MessageQueueErrorCode.UnsupportedOperation) 





{ 
string origPath = _mqPathName; 
// 工作 站 模式 下 必定 是 一 个 私有 队列 
int index = | mqPathName.ToLowerInvariant(). 
IndexOf("privateS", 
StringComparison.OrdinallgnoreCase); 





if (index == -1) 
{ 
// 获得 第 一 个 \ 
index = _mqPathName. Index0f(@"\", 
StringComparison.OrdinallgnoreCase); 
// 在 每 条 服务 器 记录 后 面 添加 privates$\ 
_mqPathName = _mqPathName.Insert(index + 1, @"private$\"); 
// 重 试 
try 
{ 





if (!MessageQueue.Exists(_mqPathName) ) 

_queue = MessageQueue.Create( mqPathName); 
else 

_queue = new MessageQueue(_mqPathName) ; 


} 


catch (Exception) 


// 将 原始 异常 设置 为 内 部 (inner) 异 常 








throw new Exception( 
S"Failed to create message queue with {origPath}" + 
$" or {_mqPathName}", mqex); 


} 
} 
} 

} 
} 
else 
{ 

_queue = new MessageQueue( mqPathName); 
} 


} 


SendMessage J iA IR] #4) x ER c n e vr JA Fl XS — AIA. THUS HH body 参数 提供 ， 然 后 
创建 并 填充 一 个 System.Messaging.Message HJ 3: ffl, BinaryMessageFormatter 用 于 格式 化 
消息 ， 因 为 与 默认 的 XmlMessageFormatter 相 比 ， 它 能 够 使 用 更 少 的 资源 发 送 更 大 的 消息 。 
通过 将 Recoverable 属性 设置 为 true 可 将 消息 设置 为 持久 的 (使 消息 持久 保存 直到 它们 被 
处 理 ， 不 会 引发 机 器 断 电 而 丢失 )。 最 后 设置 Body 并 发 送 消 息 。 


public void SendMessage(string label, string body) 
{ 



































Message msg = new Message(); 
// 标记 消息 
msg.Label = label; 

// 用 二 进 制 来 代 检 默认 的 XML 格 式 化 

// 因为 它 更 快 (代价 是 调试 时 的 易 读 性 ) 
msg.Formatter = new BinaryMessageFormatter(); 
// 将 此 消息 设置 为 持久 的 (导致 消息 将 被 写 入 磁盘 ) 
msg.Recoverable = true; 

msg.Body = body; 

_queue?.Send(msg); 






































} 


ReadMessage 方法 通过 创建 一 个 Message 对 象 并 调用 其 Receive 方法 ， 从 构造 函数 建立 的 队 
列 中 读 取 消息 。Message 的 消息 格式 化 器 被 设置 为 BinaryMessageFormatter ， 因 为 它 是 我 们 
写 入 队列 的 方式 。 最 后 ， 从 方法 中 返回 消息 体 。 


public string ReadMessage() 











{ 
Message msg = null; 
msg = _queue.Receive(); 
msg.Formatter = new BinaryMessageFormatter(); 
return (string)msg.Body; 
} 


#region IDisposable Members 


public void Dispose() 

{ 
Dispose(true); 
GC.SuppressFinalize(this); 








private void Dispose(bool disposing) 
if (!this._disposed) 


if (disposing) 
_queue.Dispose(); 


_disposed = true; 
} 
} 


#endregion 


} 
为 了 展示 如 何 使 用 MQWorker 类 ， 下 面 的 示例 生成 一 个 MQworker。 它 随后 会 使 用 SendMessage 
发 送 一 条 消息 (一 小 段 XML) 并 使 用 ReadMessage 获取 它 。 


// 注意 :必须 先 设置 好 消息 队列 服务 ,本 例 才能 正常 工作 
// 可 以 在 “添加 /删除 Windows 组 件 " 中 添加 此 服务 
































using (MQWorker mqw = new MQWorker(@".\MQWorkerQ")) { 
string xml = "<MyXml><InnerXml Location=\"inside\"/></MyXml>"; 
Console.WriteLine("Sending message to message queue: " + xml); 
mqw.SendMessage("Label for message", xml); 
string retXml - mqw.ReadMessage(); 
Console.WriteLine("Read message from message queue: " + retXml); 


13.4.8 iit 

消息 队列 在 你 试图 为 可 扩展 性 目的 而 分 发 处 理 负 和 载 时 非常 有 用 。 毫 无 疑问 ， 使 用 消息 队 
列 会 为 处 理 增 加 开销 ， 因 为 消息 必须 遍历 MSMQ 的 基础 架构 。 尽 管 如 此 ， 一 个 好 处 是 
MSMQ 允许 应 用 程序 在 多 台 机 器 上 运行 ， 因 此 处 理 时 可 能 最 终 歼 益 。 另 一 个 好 处 是 消息 队 
列 提供 可 靠 的 消息 异步 处 理 ， 因 此 发 送 方 可 以 确信 接收 方 将 会 得 到 消息 而 无 需 发 送 方 等 待 
确认 。 消 息 队 列 服务 默认 未 安装 ,但 可 以 通过 控制 面板 中 的 “添加 /删除 Windows 组 件 ” 
小 程序 进行 安装 。 
使 用 消息 队列 以 缓冲 大 量 请 求 的 处 理 逻 辑 〈 例 如 前 面 所 示 的 Web 服务 情况 ) 会 带 来 更 好 的 
稳定 性 ， 在 多 台 机 器 上 使 用 多 个 读 取 进程 最 终 会 为 应 用 程序 产生 更 大 的 吞吐 量 。 
























































13.4.4 ”参考 
MSDN 文档 中 的 “Message 类 ”和 “MessageQueue 类 ”主题 。 


13.5 ”捕获 标准 输出 流 的 输出 


13.5.1 问题 
你 希望 捕获 自己 的 CH 程序 中 将 会 出 现在 标准 输出 流 中 的 输出 。 
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13.5.2 ”解决 方案 





使 用 Console.SetOut 方法 捕获 和 释放 标准 输出 流 。Setout 将 标准 输出 流 设置 为 传递 给 
它 的 任何 基于 System.10.TextWriter 的 流 。 为 了 将 输出 捕获 到 一 个 文件 中 ， 可 创建 一 个 
StreamWriter 以 写 入 到 文件 ， 并 且 使 用 Setout 设置 该 写 入 器 。 使 用 Path.GetTempFileName 


获得 一 个 位 置 ， 来 写 和 调用 代码 方 可 访问 的 日 志 。 


现在 ， 当 调用 Console.WriteLine 时 ， 输 出 会 到 达 StreamWriter， 而 不 是 stdout, 


所 示 。 


try 
{ 
Console.WriteLine("Stealing standard output!"); 
string logfile = Path.GetTempFileName(); 
Console.WriteLine($"Logging to: {logfile}"); 
using (StreamWriter writer = new StreamWriter(logfile)) 





{ 
// 为 我 们 的 目的 截取 stdout 
Console.SetOut(writer); 
Console.WriteLine("Writing to the console... NOT!"); 
for (int i = 0; i < 10; i++) 
Console.WriteLine(i); 
} 
} 
catch(IOException e) 
{ 
Debug.WriteLine(e.ToString()); 
return ; 
} 


如 下 


为 了 恢复 向 标准 输出 流 写 入 ， 创 建 另 一 个 StreamWriter。 这 一 次 调用 Console.OpenStandar - 


d0 
次 出 现在 控制 台 上 。 
// 恢复 标准 输出 流 , 以 显示 完成 消息 


ES 












































StreamWriter standardOutput = new StreamWriter(Console.OpenStandardOutput()); 


standardOutput.AutoFlush - true; 


Console.SetOut(standardOutput); 
Console.WriteLine("Back to standard output!"); 


该 代码 的 控制 台 输 出 如 下 所 示 。 


Stealing standard output! 
Logging to: C:\Users\user\AppData\Local\Temp\tmpFE7C. tmp 
Back to standard output! 


代码 执行 之 后 ， 我 们 创建 的 日 志文 件 包含 下 列 内 容 。 


Writing to the console... NOT! 
0 
1 


tput 方法 获取 标准 输出 流 并 使 用 Setout 再 次 设置 它 。 现 在 调用 Console.WriteLine 将 再 








WO om、~ wm 上 UJ n2 


13.5.3 ”讨论 


在 程序 内 重 定向 标准 输出 流 看 起 来 有 些 过 时 。 但 是 ， 要 考虑 到 使 用 其 他 向 该 流 中 写 入 信息 
的 类 的 情况 。 你 不 希望 输出 出 现在 自己 的 应 用 程序 中 ， 但 又 必须 使 用 该 类 。 这 在 创建 一 个 
小 的 启动 程序 以 捕获 来 自控 制 台 应 用 程序 的 输出 时 或 者 在 使 用 一 个 第 三 方程 序 集 〈 该 程序 
集 不 断 输 出 大 量 可 能 会 让 你 的 用 户 困 扰 的 详细 信息 ) 时 也 非常 有 用 。 
































13.5.4 84 


MSDN x f P AY *Console.SetOut 7j ze " “Console.OpenStandardOutput 7j jÀ ” "Path. 
GetTempFilePath 方法 ”和 “StreamWriter 类 ”主题 。 


13.6 捕获 一 个 进程 的 标准 输出 


13.6.1 问题 
你 需要 能 够 捕获 你 启动 的 一 个 进程 的 标准 输出 。 


13.6.2 ”解决 方案 


使 用 Process.StartInfo 类 的 RedirectStandardOutput 属性 来 捕获 进程 的 输出 。 通 过 重 定 
向 进程 的 标准 输出 流 ， 你 可 以 在 进程 终止 时 读 取 它 。UseShellExecute 是 ProcessInfo 类 的 
一 个 属性 ， 用 于 指示 运行 时 是 否 使 用 Windows shell 来 启动 进程 。 它 默认 是 打开 的 (true)， 
并 且 shell 运行 该 程序 ， 这 意味 着 不 能 重 定向 输出 。UseShellExecute 需要 被 关闭 (设置 为 
false)， 以 使 重 定 向 能 够 发 生 。 


在 此 示例 中 ， 为 cmd.exe 设置 了 一 个 Process 对 象 ， 该 对 象 带 有 用 于 执行 目录 列表 的 参数 ， 
然后 输出 被 重 定向 。 创 建 一 个 日 志文 件 以 保存 输出 结果 ， 然 后 调用 Process.Start 方法 。 
Process application = new Process(); 
// 运行 命令 shell 
application.StartInfo.FileName = Q"cmd.exe"; 






































// 从 当前 目录 获得 目录 列表 

application.StartInfo.Arguments = @"/Cdir " + Environment.CurrentDirectory; 

Console.WriteLine($"Running cmd.exe with arguments:" + 
$"(application.StartInfo.Arguments]"); 
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// 重 定向 输出 ,以 便 我 们 能 够 读 取 它 
application.StartInfo.RedirectStandardOutput = true; 
application.StartInfo.UseShellExecute - false; 





// 创建 一 个 日 志文 件 以 保存 结果 

string logfile = Path.GetTempFileName(); 
Console.WriteLine($"Logging to: {logfile}"); 

using (StreamWriter logger = new StreamWriter(logfile)) 


// 启动 它 


application.Start(); 











一 旦 进程 启动 ， 就 可 以 访问 StandardOutput 流 并 保存 一 个 引用 。 应 用 程序 一 结束 ， 代 码 就 








读 取 应 用 程序 运行 时 写 入 输出 流 的 信息 ， 并 将 其 写 入 之 前 建立 的 日 志文 件 中 。 最 后 ， 关 闭 
日 志文 件 ， 然 后 Process 对 象 也 会 被 关闭 。 





application.WaitForExit(); 
string output = application. StandardOutput.ReadToEnd(); 


logger .Write(output); 


} 
// 关闭 进程 对 象 


application.Close(); 








我 们 使 用 Path.GetTempPathrile 创建 的 临时 日 志文 件 保存 的 信息 类 似 于 下 面 的 输出 。 











Volume in drive C has no label. 
Volume Serial Number is DDDD-FFFF 


Directory of C:\CS60_Cookbook\CSCB6\CSharpRecipes\bin\Debug 
04/11/2015 04:27 PM <DIR> 


04/11/2015 04:27 PM <DIR> xd 
02/05/2015 10:06 PM 724 BigSpenders.xml 


02/05/2015 10:05 PM 719 Categories.xml 

02/05/2015 04:04 PM 64,566 CSCBCover .bmp 

12/31/2014 05:23 PM 489,269 CSharpCookbook.zip 
04/11/2015 04:27 PM 495,616 CSharpRecipes.exe 

04/11/2015 04:27 PM 31,154 CSharpRecipes.exe.CodeAnalysisLog. xml 
02/05/2015 09:53 PM 3,075 CSharpRecipes.exe.config 
04/11/2015 04:27 PM 0 

CSharpRecipes.exe. Lastcodeanalysissucceeded 

04/11/2015 04:27 PM 775,680 CSharpRecipes.pdb 

02/05/2015 04:04 PM 5,190,856 EntityFramework.dll 
02/05/2015 04:04 PM 620,232 EntityFramework.SqlServer.dll 
02/05/2015 04:04 PM 154,645 EntityFramework.SqlServer.xml 
02/05/2015 04:04 PM 3,645,119 EntityFramework. xml 
03/09/2015 02:51 PM 6,569 IngredientList.txt 

04/04/2015 09:55 AM 513,536 Newtonsoft.Json.dll 
04/04/2015 09:55 AM 494,336 Newtonsoft.Json.xml 
03/09/2015 02:51 PM 4,390,912 Northwind.mdf 

04/06/2015 04:11 PM 51,712 NorthwindLinqg2Sql.dll 
04/06/2015 04:11 PM 128,512 NorthwindLing2Sql. pdb 
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04/11/2015 01:18 PM 573,440 Northwind log.ldf 


03/09/2015 02:51 PM 80 RecipeChapters.txt 
04/06/2015 04:11 PM 16,384 SampleClassLibrary.dll 
04/06/2015 04:11 PM 1,283 SampleClassLibrary.dll.CodeAnalysisLog.xml 
04/06/2015 04:11 PM 0 
SampleClassLibrary.dll.lastcodeanalysissucceeded 
04/06/2015 04:11 PM 11,776 SampleClassLibrary.pdb 
12/02/2014 03:35 PM 387 SampleClassLibraryTests.xml 
04/11/2015 03:48 PM 8,704 SharedCode.dll 
04/11/2015 03:48 PM 15,872 SharedCode.pdb 
28 File(s) 17,685,158 bytes 


2 Dir(s) 67,929,718,784 bytes free 


13.6.3 iit 

重 定向 标准 输出 流 对 于 自动 构建 场景 或 测试 工具 等 任务 是 非常 有 用 的 。 虽 然 并 不 像 在 命令 
提示 符 中 在 一 个 进程 命令 行 后 添加 > 那么 简单 ， 但 这 一 方法 更 加 灵活 ， 因 为 流 输出 可 重新 
格式 化 为 XML 或 HTML 以 发 布 到 一 个 网 站 。 它 还 能 提供 将 数据 同时 发 送 到 多 个 位 置 的 机 
会 ， 而 这 是 Windows 简单 的 命令 行 重 定向 功能 无 法 做 到 的 。 

等 待 直 到 应 用 程序 完成 之 后 从 再 从 流 中 读 取 ， 可 确保 没有 死 锁 问 题 。 如 果 流 在 此 之 前 被 同 
步 访问 ， 那 么 有 可 能 父 进 程 会 阻塞 子 进程 。 至 少 ， 子 进程 将 会 等 待 父 进程 完成 从 流 中 读 取 
之 后 才能 继续 写 入 其 中 。 因 此， 通过 把 读 取 延 迟到 结束 之 后 ， 避 免 了 子 进程 的 性 能 降级 ， 
而 代价 是 结束 之 后 的 一 些 额 外 时 间 。 
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MSDN 文档 中 的 “ProcessStartInfo.RedirectStandardoutput 属性 ”和 “ProcessStartInfo. 
UseShellExecute 属性 ”主题 。 


13.7 ”在 它 自己 的 AppDomain 中 运行 代码 


13.7.1 问题 
你 希望 运行 与 应 用 程序 主要 部 分 隔离 开 的 代码 。 


13.7.2 ”解决 方案 


使 用 AppDomain.CreateDomain 方法 创建 一 个 单独 的 AppDomain 来 运行 代码 。CreateDomain 
允许 应 用 程序 控制 创建 的 AppDomain 的 许多 方面 ， 例 如 安全 环境 、AppDomain 设置 以 及 
AppDomain 的 基本 路 径 。 为 了 举例 说 明 这 一 点 ， 下 列 代码 创建 了 RunMe 类 的 一 个 实例 (在 本 
范例 中 随后 将 详细 介绍 ) 并 调用 PrintCurrentAppDomainName 方法 。 它 会 输出 代码 运行 所 在 
的 AppDomain 的 名 称 。 


AppDomain myOwnAppDomain = AppDomain.CreateDomain("MyOwnAppDomain"); 
// 输出 当前 AppDomain 的 名 称 
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RunMe rm = new RunMe(); 
rm.PrintCurrentAppDomainName(); 


现在 ， 通 过 调用 AppDomain 上 的 CreateInstance 在 "MyOwnAppDomain" AppDomain 中 生成 RunMe 
类 的 一 个 实例 。 我 们 将 用 于 构造 该 类 型 所 必需 的 模块 和 类 型 信息 传递 给 CreateInstance, ifj 
它 返 回 一 个 ObjectHandle, 


然后 ， 通 过 返回 的 ObjectHandle 并 使 用 Unwrap 方法 将 其 转换 为 一 个 RunMe 引用 ， 获 得 一 个 
在 AppDomain 中 运行 的 实例 的 代理 。 


// 在 新 的 应 用 程序 域 中 创建 RunMe 
Type adType = typeof(RunMe); 
ObjectHandle objHdl = 
myOwnAppDomain.CreateInstance(adType.Module.Assembly.FullName, 
adType.FullName); 
// 拆 开 引用 
RunMe adRunMe = (RunMe)objHdl.Unwrap(); 
































{E "MyOwnAppDomain" AppDomain 中 的 RunMe 实例 上 调用 PrintCurrentAppDomainName 方法 ， 


H 


它 会 输出 "Hello from MyOwnAppDomain!", Mrt AppDomain.Unload E$% AppDomain, Ski Fe 
2k 























// 对 工具 箱 进行 一 次 调用 


adRunMe.PrintCurrentAppDomainName(); 











// 现在 卸载 应 用 程序 域 

AppDomain.Unload(myOwnAppDomain); 
RunMe 类 的 定义 如 下 所 示 。 它 继承 自 MarshalByRefobject， 因 为 它 允 许 你 在 调用 
ObjectHandle 上 的 Unwrap 时 获取 代理 ， 并 将 类 上 的 调用 远程 传递 到 新 的 AppDomain, 
PrintCurrentAppDomainName 方法 简单 地 访问 当前 AppDomain 上 的 FriendlyName 属性 并 输出 
“Hello from (AppDomain)" iB E. 














public class RunMe : MarshalByRefObject 


{ 
public RunMe() 
{ 
PrintCurrentAppDomainName(); 
} 
public void PrintCurrentAppDomainName( ) 
{ 
string name = AppDomain.CurrentDomain.FriendlyName; 
Console.WriteLine($"Hello from {name}!"); 
} 
} 


该 示例 的 输出 如 下 所 示 。 


Hello from CSharpRecipes.exe! 
Hello from CSharpRecipes.exe! 
Hello from MyOwnAppDomain! 
Hello from MyOwnAppDomain! 








13.7.3 讨论 


将 代码 隔离 到 一 个 单独 的 AppDomain 中 对 于 像 本 示例 这 样 琐 碎 的 情况 有 点 浪费 ， 但 是 它 
举例 说 明了 可 以 在 应 用 程序 创建 的 AppDomain 中 远程 执行 代码 。CreateDomain 方法 有 6 种 
重 载 ， 每 种 都 为 AppDomain 的 创建 增加 了 一 点 复杂 性 。 在 隔离 或 定制 配置 的 好 处 超过 了 
设置 一 个 单独 AppDomain 以 及 调试 其 中 代码 的 复杂 性 的 情况 下 ， 它 是 一 种 很 有 用 的 工具 。 
一 个 很 好 的 真实 示例 就 是 建立 一 个 单独 的 AppDomain 以 运行 通常 的 ASP.NET 环境 之 外 
的 ASP.NET 网 页 (虽然 这 的 确 是 一 个 很 重要 的 用 法 ) 或 者 是 将 第 三 方 代码 加 载 到 第 二 个 
AppDomain 中 进行 隔离 。 

















13.7.4 ”参考 


MSDN 文档 中 的 “AppDomain 2E” "AppDomain.CreateDomain 7j 7” FN “ObjectHandle 2E" 
主题 。 


13.8 确定 当前 操作 系统 的 操作 系统 和 Service 
Pack 版 本 


13.8.1 问题 
你 希望 知道 当前 操作 系统 和 Service Pack 的 信息 。 


13.8.2 ”解决 方案 


使 用 例 13-4 所 示 的 GetOSAndServicePack 方法 ,获得 代表 当前 操作 系统 和 Service Pack 的 
= FF EB, GetOSAndServicePack 使 用 Environment.OSVersion 属性 获得 操作 系统 (OS) 的 
版 本 信息 ， 然 后 从 中 确定 OS 的“ 官方” 名称。 从 Environment.OSVersion 中 获取 的 
OperatingSystem 类 拥有 一 个 名 为 ServicePack 的 Service Pack 属性 。 这 些 值 全 都 是 作为 操 
作 系 统 名 称 、 版 本 和 Service Pack 字符 串 返 回 的 。 


例 13-4: GetOSAndServicePack 方法 
public static string GetOSAndServicePack() 


{ 




















// 获得 当前 05 信 息 
OperatingSystem os = Environment.OSVersion; 
RegistryKey rk = 
Registry.LocalMachine.OpenSubKey( 
@"SOFTWARE\Microsoft\Windows NT\CurrentVersion"); 
string osText = (string)rk?.GetValue("ProductName" ) ; 
if (string.IsNullOrWhiteSpace(osText)) 
osText = os.VersionString; 
else 
osText = ( 
S"{osText} {os.Version.Major}.{os.Version.Minor}.{os.Version.Build}"); 
if (!string.IsNullOrWhiteSpace(os.ServicePack)) 
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osText = $"{osText} (os.ServicePack]"; 
return osText; 


} 


13.8.3 ”讨论 

让 你 的 应 用 程序 能 够 获知 当前 操作 系统 和 Service Pack 允许 你 在 调试 报告 和 应 用 程序 的 
“关于 ”对 话 框 (如 果 有 的 话 ) 中 包含 该 信息 。 这 一 简单 知识 通过 支持 部 门 传送 后 ， 能 够 
节省 你 数 小 时 的 调试 时 间 。 让 这 一 信息 可 用 是 很 值得 的 ， 这 样 用 户 支 持 部 门 就 能 够 在 客户 
无 法 定位 时 轻松 指导 他 们 。 














13.84 ”参考 


MSDN 文档 中 的 “Environment.0SVersion 属性 ”和 “0peratingSystem 类 ”主题 。 











关于 作者 


Jay Hilyard 为 Windows 平台 开发 应 用 已 经 有 20 多 年 ， 为 .NET 平台 开发 应 用 也 超过 了 15 
年 。 他 在 MSDN Magazine 上 发 表 过 很 多 文章 ， 目 前 在 新 罕 布 什 尔 州 朴 英 茅 斯 的 Newmarket 
(Amadeus 的 一 家 子 公司 ) 工作 。 





Stephen Teilhet 从 pre-alpha 版 就 开始 使 用 .NET 平台 ， 并 且 一 直 使 用 至 今 。 他 任职 于 IBM, 
是 源 代码 静态 安全 分 析 工 具 的 主管 安全 研究 员 。 这 一 工具 用 于 发 现 多 种 语言 中 的 安全 汤 
洞 ， 例 如 Cf 和 Visual Basic, 


关于 封面 


《C# 经 典 实例 (第 4 版 )》 封 面 上 的 动物 是 袜 带 蛇 (Thamnophis sirtalis) 。 之 所 以 这 么 命名 ， 
是 因为 它们 身体 上 的 纵向 条 纹 看 起 来 十 分 像 是 过 去 用 于 固定 男 式 短 袜 的 袜 带 。 袜 带 蛇 很 容 
易 通过 其 独特 的 条 纹 辨 识 出 来 : 在 背部 的 中 间 部 分 有 窒 条 纹 ， 而 在 两 侧 是 宽 条 纹 。 颜 色 和 
样式 变化 使 它们 能 够 融入 所 处 的 自然 环境 中 ， 帮 助 它们 躲避 捕食 者 。 它 们 是 北美 最 常见 的 
一 种 蛇 ， 并 且 是 在 阿拉 斯 加 发 现 的 唯一 蛇 类 。 

袜 带 蛇 有 着 龙骨 状 鲜 片 ， 沿 鲜 片 中 轴 向 下 有 一 条 或 多 条 又 ， 给 它们 一 种 粗糙 的 纹理 和 了 瞳 淡 
的 外 观 。 成 年 袜 带 蛇 身 长 一 般 在 46~130 厘米 之 间 (一 英尺 半 到 四 英尺 )。 坎 蛇 通 常 比 雄 蛇 
大 ， 但 尾巴 较 短 ， 身 体 和 尾巴 相连 处 有 隆起 。 
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蛋 壳 和 粘膜 都 已 经 破 开 ， 所 以 小 蛇 会 直接 降生 。 人 偶尔 ， 小 蛇 出 生 时 还 在 软 壳 里 。 肉 蛇 通 常 
会 生 10 到 40 条 小 蛇 ;， 一 条 袜 带 蛇 生 出 的 存活 小 蛇 数 量 最 高 记录 是 98 条 。 一 旦 小 蛇 从 母 
体 脱 离 ， 它 们 就 完全 独立 并 且 需 要 保护 自己 。 在 这 段 时 间 ， 它 们 是 最 容易 遭 到 捕食 的 ， 超 
过 一 半 的 小 蛇 都 会 在 1 岁 前 死 掉 。 

只 有 少数 动物 能 捕食 蟾 内 、 蝶 归 等 具有 很 强化 学 防卫 能 力 的 两 栖 动 物 ， 袜 带 蛇 就 是 其 中 之 
一 。 尽 管 食物 取决 于 它们 所 处 的 环境 ,但 袜 带 蛇 主 要 还 是 吃 蝗 如 和 两 栖 动 物 ， 偶尔 会 吃 锥 
鸟 、 鱼 和 小 型 哮 次 目 动物 。 袜 带 蛇 有 毒液 (但 对 人 体 无 害 ) ， 用 于 使 猎物 崩 迷 或 者 死亡 ， 
然后 将 其 整个 天 下 。 

很 多 O'Reilly 封面 上 的 动物 都 濒临 灭绝 ， 它 们 对 于 地 球 都 是 非常 重要 的 。 想 要 了 解 更 多 有 
关 如 何 帮 助 这 些 动物 的 信息 ， 请 访问 http://animals.oreilly.com, 


封面 图 片 来 自 多 佛 画报 档案 中 一 幅 19 世纪 的 版 画 。 
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AE Ju quod 


本 书 全 面 讲解 C# 并 发 编程 技术 ， 侧 重 于 .NET 平 台 上 较 新 、 较 实用 的 方法 。 全 书 分 为 
几 大 部 分 : 首先 介绍 几 种 并 发 编程 技术 ， 包 括 异步 编程 、 并 行 编程 、TPL 数 据 流 、 响 
应 式 编程 ; 然后 前 述 一 些 重 要 的 知识 点 ， 包 括 测试 技巧 、 互 操作 、 取 消 并 发 、 函 数 式 
编程 与 OOP、 同 步 、 调 度 ; 最 后 介绍 了 几 个 实用 技巧 。 全 书 共 包含 75 个 有 配套 源码 
的 实用 方法 ， 可 用 于 服务 器 程序 、 桌 面 程 序 和 移动 端 应 用 的 开发 。 
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书号 : 978-7-115-37427-1 
定价 : 49.00 元 


本 书 共 分 为 敏捷 基础 、 编 写 SOLID 代 码 和 自 适应 实例 三 大 部 分 ， 将 理论 与 实践 相 结 
合 ， 介 绍 了 当前 使 用 Microsoft NET Framework 进 行 C# 编 程 的 最 佳 实 践 ， 详 尽 探讨 
了 C# 开 发 人 员 如 何 应 用 Scrum 等 敏捷 方案 实现 高 质量 、 自 适应 的 代码 ， 并 给 出 大 量 
敏捷 开发 实践 代码 示例 ， 是 .NET 中 高 级 程序 员 进 阶 的 实用 指南 。 
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定价 : 69.00 元 

本 书 是 世界 顶级 技术 专家 “十 年 磨 一 剑 ”的 经 典 之 作 ， 在 C# 和 .NET 领 域 享有 盛誉 。 
与 其 他 泛泛 介绍 C# 的 书籍 丰 同 ， 本 书 深度 探究 C# 的 特性 ， 并 结合 技术 发 展 ， 引 领 读 
者 深入 C# 的 时 空 。 作 者 从 语言 设计 的 动机 出 发 ， 介 绍 支持 这 些 特性 的 核心 概念 。 作 
者 将 新 的 语言 特性 放 在 C# 语 言 发 展 的 背景 之 上 ， 用 极 富 实际 意义 的 示例 ， 向 读者 展 
示 编 写 代码 和 设计 解决 方案 的 最 佳 方式 。 
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本 书 总 结 了 框架 设计 的 整体 思路 和 经 验 ， 包 含 了 常见 应 用 框架 设计 的 模式 、 框 架 灵 
活性 的 配置 和 框架 工具 的 支持 ， 有 助 于 读者 了 解 框架 设计 的 核心 思想 ， 加 深 对 框架 
设计 的 理解 ， 快 速 掌握 框架 设计 的 技巧 ， 并 在 研究 其 他 框架 时 能 够 做 到 举一反三 。 
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Illustrated C# 2012 


# 图 解 教程 


(第 4 版 ) 


























本 书 是 一 本 面向 C# 初 学 者 的 实用 教程 ,由 浅 入 深 地 讲解 了 C# 的 基础 语法 和 重要 特性 ， 
分 析 了 在 开发 中 必须 掌握 的 技术 要 领 和 经 验 心得 。 语 言 浅 显 易 懂 、 轻 松 幽 默 ， 通 过 精 
心 选 择 的 实例 和 详尽 的 代码 全 面 介 绍 了 C# 最 具 特 色 的 关键 知识 点 ， 有 助 于 初学 者 迅 
速 从 一 个 C# 开 发 的 门外汉 成 长 为 全 面 掌握 技术 要 领 的 开发 人 员 。 




































































































































































书号 : 978-7-115-38292-4 
定价 : 49.00 元 
本 书 是 广 受 赞 誉 C# 图 解 教程 的 最 新 版 本 。 作 者 在 本 书 中 创造 了 一 种 全 新 的 可 视 化 叙 
述 方式 ， 以 图 文 并 茂 的 形式 、 朴 实 简洁 的 文字 ， 并 辅 之 以 大 量 表格 和 代码 示例 ， 全 
而 、 直 观 地 阐述 了 C# 语 言 的 各 种 特性 。 通 过 本 书 ， 读 者 能 够 快速 、 深 入 地 理解 C#,， 
为 自己 的 编程 生涯 打下 良好 的 基础 。 



























































































































































书号 : 978-7-115-32090-2 

定价 : 89.00 元 

本 书 是 C# 领域 久负盛名 的 经 典 著 作 ， 深 入 全 面 地 叙述 了 C# 编 程 语言 和 .NET 平 台 的 核 
心 内 容 ， 并 以 大 量 示 例 剖 析 相 关 概 念 。 全 书 分 为 八 部 分 内 容 : C# 和 .NET 平 台 、C# 核 
心 编程 结构 、C# 面 向 对 象 编 程 、 高 级 C# 编 程 结 构 、 用 .NET 程 序 集 编程 、.NET 基 础 类 
库 、WPF 和 ASP.NET Web Forms。 
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正则 表达 式 
必 知 | 必 会 


(修订 版 ) 























FE 则 表达 式 是 一 种 威力 无 比 强大 的 武器 ， 几 乎 在 所 有 的 程序 设计 语言 里 和 计算 机 平台 
g 可 以 用 它 来 完成 各 种 复杂 的 文本 处 理工 作 。 本 书 从 简单 的 文本 匹配 开始 ， 循 序 
渐进 地 介绍 了 很 多 复杂 内 容 ， 其 中 包括 回溯 引用 、 条 件 性 求 值 和 前 后 查找 ， 等 等 。 
每 章 都 为 读者 准备 了 许多 简明 又 实用 的 示例 ， 有 助 于 全 面 、 系 统 、 快 速 掌握 正则 表 
达 式 ， 并 运用 它们 去 解决 实际 问题 。 
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O'REILLY” 





C# 经 典 实 例 (第 4 版 ) 


这 是 一 本 全 面 的 C# 编 程 参考 书 ， 用 150 多 个 范例 详细 探讨 了 C# 开 发 中 的 
诸多 问题 。 所 有 范例 中 的 代码 均 经 过 验证 ， 可 以 直接 在 应 用 程序 中 重 
用 。 


第 4 版 重新 编写 了 许多 解决 方案 ， 以 充分 利用 C# 最 近 的 创新 ， 例 如 新 的 
表达 式 级 别 功能 、 成 员 声明 功能 和 语句 级 别 功能 。 本 书 还 在 范例 中 纳 
入 了 动态 编程 和 异步 编程 的 新 应 用 ， 帮 助 读者 了 解 如 何 应 用 这 些 语言 特 
性 。 


本 书 涵盖 以 下 主题 : 

m 类 和 泛 型 

m 集合 、 枚 举 器 和 和 迭代 器 
m 数据 类 型 

m LINQ 和 lambda 表 达 式 
m 异常 处 理 

m 反射 和 动态 编程 

m 正则 表达 式 

W 文件 系统 交互 

m 网 络 和 Web 

m XML 的 使 用 

m 线程 、 同 步 和 并 发 


“ 


一 本 出 色 的 编程 指南 ， 适 合 随 

时 放 在 手边 参考 。 书 中 的 解决 

方案 和 小 提示 可 以 帮助 开发 人 
员 节 省 大 量 时 间 。” 

一 一 Steve Munyan 

国际 权威 评级 机 构 晨 星 旗下 

ByAllAccounts 公 司 

高 级 软件 工程 师 经 理 





Jay Hilyard 拥 有 20 多 年 为 Windows 
平台 开发 应 用 程序 的 经 验 ， 

为 .NET 平 台 开 发 应 用 也 超过 
了 15 年 。 他 在 MSDN Magazine 
上 发 表 过 很 多 文章 ， 目 前 
在 新 罕 布什 尔 州 朴 茨 茅 斯 的 
Newmarket (Amadeus 的 一 家 子 
公司 ) 工作 。 


Stephen Teilhet 从 pre-alpha 版 就 
开始 使 用 ,NET 平台， 并 且 一 直 使 
用 至 今 。 他 任职 于 IBM ， 是 源 代 
码 静 态 安 全 分 析 工 具 的 主管 安全 
研究 员 。 这 一 工具 用 于 发 现 多 
种 语言 中 的 安全 漏洞 ， 如 C# 和 


Visual Basic。 
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